文档

初始化操作

更新时间:

当执行 window.onload 后,容器会执行初始化操作,产生全局变量 AlipayJSBridge, 然后触发 JS Bridge 初始化完毕(AlipayJSBridgeReady)事件。

重要
  • AlipayJSBridge 注入是一个异步过程,一定要在监听该事件后调用 AlipayJSBridgeReady

  • 执行初始化操作请务必使用 ready 方法,否则可能会导致 H5 获取 AlipayJSBridge 失败。

AlipayJSBridgeReady 使用方法

function ready(callback) {
  // 如果 jsbridge 已经注入则直接调用
  if (window.AlipayJSBridge) {
    callback && callback();
  } else {
    // 如果没有注入则监听注入的事件
    document.addEventListener('AlipayJSBridgeReady', callback, false);
  }
}

代码示例

以下代码示例为 bridge 入口的标准写法:

<h1>bridge 使用方法</h1>

<script>
function ready(callback) {
  if (window.AlipayJSBridge) {
    callback && callback();
  } else {
    document.addEventListener('AlipayJSBridgeReady', callback, false);
  }
}

ready(function() {
  alert('bridge ready');
});
</script>