小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
位置
开放接口
登录
授权
设置
收货地址
chooseAddress
用户信息
帐号信息
引导关注
专业号
服务组件
直播预约/跳转/打开
设备
XHSML
性能
第三方平台
文件
数据分析
画布

xhs.chooseAddress

开发
>
JS API
>
开放接口
>
收货地址
>
chooseAddress
>
更新时间:2025-04-11 18:33:53

以Promise风格调用: 支持

获取用户收货地址。调起用户编辑收货地址原生界面,并在编辑完成后返回用户选择的地址。

参数

Object object

属性
类型
默认值
必填
说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

属性
类型
说明
userNamestring收货人姓名
provinceNamestring国标收货地址第一级地址
cityNamestring国标收货地址第二级地址
countyNamestring国标收货地址第三级地址
streetNamestring国标收货地址第四级地址
detailInfostring详细收货地址信息(包括街道地址)
nationalCodestring收货地址国家码
telNumberstring收货人手机号码
errMsgstring

实例代码

function chooseAddress() {
  return new Promise((resolve, reject) => {
    xhs.chooseAddress({
      success: (res) => {
        console.log('选择地址成功:', res);
        resolve(res); // 返回用户选择的地址信息
      },
      fail: (err) => {
        console.error('选择地址失败:', err);
        reject(err); // 返回错误信息
      },
      complete: () => {
        console.log('选择地址操作完成');
      }
    });
  });
}

// 调用示例
chooseAddress()
  .then((res) => {
    console.log('收货地址信息:');
    console.log('收货人姓名:', res.userName);
    console.log('省:', res.provinceName);
    console.log('市:', res.cityName);
    console.log('区:', res.countyName);
    console.log('街道:', res.streetName);
    console.log('详细地址:', res.detailInfo);
    console.log('国家码:', res.nationalCode);
    console.log('手机号:', res.telNumber);
  })
  .catch((err) => {
    console.error('操作失败:', err);
  });