記事のサマリー（TL;DR）
- POS Navigation APIに
navigatesuccessイベントが追加され、遷移先画面がネイティブトランジションを完了した後に発火する currententrychangeは画面が表示を終える前に発火することがあり、navigate()プロミスはトランジションの完了を待たない- この機能はAPI version 2026-10を対象とするPOS UI拡張機能で、対応するPOSビルド上でのみ利用できる
対象と移行対応について
navigatesuccessイベントは、API version 2026-10をターゲットとするPOS UI拡張機能で、かつこのイベントに対応したPOSビルド上で動作している場合にのみ利用できます。対応していない古いPOSビルドではnavigatesuccessは発火しません。既存の実装に対する移行作業は不要です。
詳細
変更内容
POS Navigation APIにnavigatesuccessイベントが追加されました。このイベントは、遷移先の画面がネイティブトランジションを完了した後に発火し、コールバックには標準のEventが渡されます。
これまで使用されていたcurrententrychangeは、画面の表示が完了する前に発火することがあります。また、navigate()が返すプロミスは、トランジションの完了を待機しません。
画面を戻る方向に遷移する場合は、再表示される側の画面にリスナーを登録する必要があります。遷移元として離脱する画面は削除されるためです。
対象範囲
このnavigatesuccessイベントは、API version 2026-10をターゲットとするPOS UI拡張機能で、かつこのイベントをサポートするPOSビルド上で動作している場合に利用できます。対応していない旧バージョンのPOSビルドでは、このイベントは発火しません。
対応方法
既存コードの移行作業は必要ありません。画面の表示が完了した後に処理を実行したい場合は、navigatesuccessイベントをリッスンしてください。navigate()プロミスを、ネイティブトランジションが完了した合図として使用しないよう注意が必要です。