記事のサマリー(TL;DR)
- Shopifyは、POS UI拡張機能向けの新API「shopify.storage.current」をAPIバージョン2026-10で利用可能にしました。
- 同一POSデバイス上の他のextension targetによるストレージ値の変更を、読み取り専用のリアクティブシグナルとして検知できます。
- 既存のStorage APIによる書き込み・削除処理には変更はなく、既存の拡張機能の対応作業も不要です。
詳細
変更内容
shopify.storage.current は、各ストレージキーを読み取り専用のリアクティブシグナルとして公開します。開発者はそのキーの現在値を読み取ることも、同一のPOSデバイス上にある同じextensionの他のtargetによる変更を購読することもできます。
値の書き込みや削除は、引き続き既存のStorage APIのメソッドを使用します。例として、バックグラウンドのtargetが顧客のロイヤルティポイントを取得・保存し、スマートグリッドのタイルがその変更に自動的に反応するという使い方が挙げられています。これにより、表示される残高を最新の状態に保つために、ストレージの繰り返し読み取りや独自のポーリング処理を実装する必要がなくなるとされています。
保存された値は非同期で読み込まれるため、シグナルの値はキーの読み込みが完了するまでの間、初期状態ではundefinedになります。この初期状態およびキーが存在しない場合の扱いについても、開発者側での対応が必要です。
対象となる範囲
この機能は、APIバージョン2026-10以降を使用するPOS UI拡張機能で利用できます。これより前のAPIバージョンを使用している拡張機能では、shopify.storage.currentを利用できません。
必要な対応
既存の拡張機能については、特別な対応は不要です。既存のStorage APIのメソッドは、これまで通り動作します。
リアクティブストレージを利用したい場合は、拡張機能をAPIバージョン2026-10以降に更新した上で、shopify.storage.currentを通じて必要なキーの読み取りや購読を行うよう実装する必要があります。
関連ドキュメントとして、POS UI拡張機能およびStorage APIリファレンスが案内されています。