PaymentRequestUpdateEvent: updateWith() メソッド
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
updateWith()
は PaymentRequestUpdateEvent
インターフェイスのメソッドで、既存の PaymentRequest
の詳細を更新します。
構文
updateWith(details)
引数
details
-
決済リクエストに適用された変更を指定するオブジェクトです。
displayItems
省略可-
オブジェクトの配列で、それぞれが決済リクエストの 1 行を記述しています。これらは領収書や請求書の行を表し、それぞれ以下のプロパティを持ちます。
amount
-
アイテムの金銭的価値を記述するオブジェクト。このオブジェクトには、以下のフィールドが記載されます。
label
-
課金される商品や サービスの、人間が読み取り可能な名称や説明を指定する文字列。インターフェイスのデザインによっては、ユーザーエージェントによってユーザーに表示されることもあります。
pending
-
論理値で、指定した
amount
がまだ確定していない場合はtrue
となります。これは、配送先住所や配送オプションなどの選択によって変わる送料や税額などの項目を示すために使用することができます。ユーザーエージェントはこの情報を示すことができますが、そうする必要はありません。
error
省略可 非推奨;-
文字列で、ユーザーに提示するエラーメッセージ指定します。
updateWith()
を呼び出す際、更新データにerror
を含めると、ユーザーエージェントに一般的なエラーメッセージとしてその文字列が表示されます。住所フィールド固有のエラーについては、shippingAddressErrors
を使用してください。 modifiers
省略可-
PaymentDetailsModifier
オブジェクトの配列で、それぞれ具体的な決済方法識別子の変更するための記述となっています。例 えば、選択した決済方法に基づいて総支払額を調整するために使用することができます (「5% の現金割引! 」)。 shippingAddressErrors
省略可 非推奨;-
配送先住所の各プロパティで検証できなかったエラーメッセージを含めることができる
AddressErrors
オブジェクト。 shippingOptions
省略可-
PaymentShippingOption
オブジェクトの配列。それぞれのオブジェクトは、ユーザーが選ぶことができる利用できる配送オプションの 1 つを記述します。 total
省略可-
displayItems
のオブジェクトと同じプロパティを持つオブジェクトで、決済に関する最新の合計を提供する。これがdisplayItems
のすべてのアイテムの合計と等しいことを確認してください。これは自動的に計算されるものではありません。支払総額が変わるたびに、この値を自分で更新する必要があります。これにより、税金や割引、その他請求金額の合計を調整するようなことを処理するための柔軟性を持つことができます。
返値
なし (undefined
)。
仕様書
Specification |
---|
Payment Request API # dom-paymentrequestupdateevent-updatewith |
ブラウザーの互換性
BCD tables only load in the browser