全部產品
Search
文件中心

Mobile Platform as a Service:初始化操作

更新時間:Jul 23, 2024

當執行 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>