すべてのプロダクト
Search
ドキュメントセンター

Mobile Platform as a Service:初期化

最終更新日:Jan 29, 2026

window.onload が実行されると、コンテナーが初期化されます。このプロセスにより、AlipayJSBridge グローバル変数が作成され、AlipayJSBridgeReady イベントがトリガーされます。

重要
  • AlipayJSBridge は非同期にインジェクトされるため、ブリッジを呼び出す前に、必ず AlipayJSBridgeReady イベントをリッスンしてください。

  • 初期化には必ず ready メソッドを使用してください。そうしないと、HTML5 ページが AlipayJSBridge を取得できない場合があります。

AlipayJSBridgeReady の使用方法

function ready(callback) {
  // JS ブリッジの準備ができたら、コールバックを呼び出します。
  if (window.AlipayJSBridge) {
    callback && callback();
  } else {
    // 準備ができていない場合は、ready イベントをリッスンします。
    document.addEventListener('AlipayJSBridgeReady', callback, false);
  }
}

コード例

次のコード例は、bridge の標準的なエントリーポイントを示しています。

<h1>How to use the bridge</h1>

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

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