PaymentRequestUpdateEvent: updateWith() 方法

語法

updateWith(details)

引數

details

一個物件或一個解析為物件的 Promise，指定應用於支付請求的更改。

displayItems 可選

一個物件陣列，每個物件描述支付請求的一行專案。這些代表收據或發票上的專案，每個專案都有以下屬性：

amount

描述專案貨幣價值的物件。此物件包含以下欄位：

currency

一個字串，包含一個有效的 3 字母 ISO 4217 貨幣識別符號（ISO 4217），指示 value 支付所使用的貨幣。

value

一個字串，包含一個有效的十進位制值，表示構成支付金額的貨幣數量。此字串只能包含一個可選的前導 "-" 來表示負值，然後是一個或多個數字（0-9），以及一個可選的小數點（"."，不考慮地區設定），後面至少跟一個數字。不允許有空格。

label

一個字串，指定要收費的專案或服務的可讀名稱或描述。這可能會由 使用者代理 顯示給使用者，具體取決於介面的設計。

pending

一個布林值，如果指定的 amount 尚未確定，則為 true。這可用於顯示依賴於收貨地址、送貨選項等選擇的運費或稅費等專案。使用者代理可以顯示此資訊，但並非必須這樣做。

error 可選 已棄用 非標準

一個字串，指定要顯示給使用者的錯誤訊息。呼叫 updateWith() 時，在更新的資料中包含 error 會導致 使用者代理 將文字顯示為一般錯誤訊息。對於特定於地址欄位的錯誤，請使用 shippingAddressErrors 欄位。

modifiers 可選

一個 PaymentDetailsModifier 物件陣列，其屬性在 PaymentRequestEvent.modifiers 中進行描述。

例如，您可以使用其中一個來根據選定的付款方式調整總支付金額（“5% 現金折扣！”）。

shippingAddressErrors 可選 已棄用 非標準

一個物件，其中包含未能驗證的送貨地址每個屬性的錯誤訊息。

shippingOptions 可選 已棄用 非標準

一個物件陣列，每個物件描述使用者可以選擇的一個可用送貨選項。

total 可選

一個具有與 displayItems 中的物件相同的屬性的物件，提供支付的更新總計。確保此值等於 displayItems 中所有專案的總和。此值不會自動計算。每次總金額到期更改時，您都必須自行更新此值。這使您能夠靈活地處理稅費、折扣以及其他對總收取價格的調整。

返回值

無（undefined）。

規範

瀏覽器相容性