小程序开放平台

文档中心
基础
界面
网络
数据缓存
媒体
位置
开放接口
登录
授权
设置
getSetting
openSetting
发小红书笔记
跳转 AI 能力法务协议
设备
XHSML
性能
文件
数据分析
画布

xhs.openSetting

开发
>
JS API
>
开放接口
>
设置
>
openSetting
>
更新时间:2025-04-11 17:03:43

以Promise风格调用: 支持

调起客户端小程序设置界面,返回用户设置的操作结果。设置界面只会出现小程序已经向用户请求过的权限。

参数

Object object

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

object.success 回调函数

属性
类型
说明
errMsgstring
authSettingobject用户授权结果

实例代码

function openSetting() {
  return new Promise((resolve, reject) => {
    xhs.openSetting({
      success: (res) => {
        console.log('打开设置界面成功:', res);
        resolve(res); // 返回用户设置的操作结果
      },
      fail: (err) => {
        console.error('打开设置界面失败:', err);
        reject(err); // 返回错误信息
      },
      complete: () => {
        console.log('打开设置界面操作完成');
      }
    });
  });
}

// 调用示例
openSetting()
  .then((res) => {
    console.log('用户授权设置:', res.authSetting);
  })
  .catch((err) => {
    console.error('操作失败:', err);
  });