小程序开放平台

文档中心
基础
路由
跳转
restartMiniProgram
exitMiniProgram
转发
界面
网络
支付
数据缓存
媒体
位置
开放接口
设备
XHSML
性能
第三方平台
文件
数据分析
画布

xhs.restartMiniProgram

开发
>
JS API
>
跳转
>
restartMiniProgram
>
更新时间:2025-04-10 15:28:56

以Promise风格调用: 支持

重启当前小程序

参数

Object object

属性
类型
默认值
必填
说明
pathstring打开的页面路径,path 中 ? 后面的部分会成为 query
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

属性
类型
说明
errMsgstring

实例代码

// 调用 restartMiniProgram 重启当前小程序
xhs.restartMiniProgram({
  path: '/pages/index/index?foo=bar', // 可选,重启后打开的页面路径及 query 参数
  success: (res) => {
    console.log('小程序重启成功:', res.errMsg);
  },
  fail: (err) => {
    console.error('小程序重启失败:', err.errMsg);
  },
  complete: () => {
    console.log('restartMiniProgram 调用结束');
  }
});