移动开发平台 mPaaS 关闭多个页面

此接口用于一次回退多级页面。

注意：只允许 popTo 到当前 App 实例内的页面，不允许跨 appId 跳转。

popTo 接口的使用方法

  

   
// 关闭当前打开的页面
   
AlipayJSBridge.call('popTo', {
   
 index: -1
   
});
  

代码示例

• 关闭当前页面并且传递数据：

      
  
       
  <h1>点击"执行"关闭当前页面并返回数据</h1>
       
  <a href="#" class="btn J_demo">执行</a>
       
  <script>
       
  function ready(callback) {
       
  // 如果 jsbridge 已经注入则直接调用
       
  if (window.AlipayJSBridge) {
       
   callback && callback();
       
  } else {
       
   // 如果没有注入则监听注入的事件
       
   document.addEventListener('AlipayJSBridgeReady', callback, false);
       
  }
       
  }
       
  ready(function(){
       
  document.querySelector('.J_demo').addEventListener('click', function() {
       
   // 传递的 data 对象将会被即将露出的页面通过 resume 事件接收
       
   AlipayJSBridge.call('popTo', {
       
   index: -1, // 回退到上一个页面，假如这个时候没有上一个页面，就会报错
       
   data: { // 特别强调：data 是字典，不是数组
       
   from: location.href,
       
   info: Date.now()
       
   }
       
   }, function(e) { // 添加回调，因为 popTo 不一定会成功（当前页面是唯一打开的页面的时候，会报错）
       
   alert(JSON.stringify(e));
       
   });
       
  });
       
  });
       
  </script>
      

• 通过 urlPattern 返回到符合正则匹配的页面：

      
  
       
  <h1>返回到符合某个规则的 URL</h1>
       
  <h3></h3>
       
  <a href="javascript:void(0)" class="btn J_new_window">新窗口打开当前页面</a>
       
  <a href="javascript:void(0)" class="btn J_demo">返回</a>
       
  <script>
       
  var query = getQuery();
       
  var depth = (+query.depth) || 0;
       
  document.querySelector('h3').innerHTML = '当前页面深度: ' + depth;
       
  function ready(callback) {
       
  // 如果 jsbridge 已经注入则直接调用
       
  if (window.AlipayJSBridge) {
       
   callback && callback();
       
  } else {
       
   // 如果没有注入则监听注入的事件
       
   document.addEventListener('AlipayJSBridgeReady', callback, false);
       
  }
       
  }
       
  ready(function(){
       
  document.querySelector('.J_demo').addEventListener('click', function() {
       
   AlipayJSBridge.call('popTo', {
       
   urlPattern: 'pop-to-url-pattern.html',
       
   }, function(e) {
       
   alert(JSON.stringify(e));
       
   });
       
  });
       
  
       
  document.querySelector('.J_new_window').addEventListener('click', function() {
       
   AlipayJSBridge.call('pushWindow', {
       
   url: location.pathname + '?depth=' + (1+depth),
       
   });
       
  });
       
  });
       
  </script>
      

API

  

   
AlipayJSBridge.call('popTo',{
   
 index, urlPattern
   
}, fn)
  

index、urlPattern 是 2 种查询模式，不应该被同时使用。

入参

出参

错误码描述

注意事项

• 一般情况下，popTo 用于分多步才能完成的场景，比如用户信息完善时回退，三级地址选择后返回等。
• 如果通过 urlPattern 来返回，popTo 会返回到离当前页面最远的页面，也就是栈底。同时不会去检测当前页面的 URL 是否符合。
• 关于 popTo 时所带的数据如何被接收，请查看 页面恢复运行（resume 事件）。