PaymentMethodChangeEvent
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The PaymentMethodChangeEvent()
constructor creates a new PaymentMethodChangeEvent
object providing
details about a paymentmethodchange
event.
Syntax
paymentMethodChangeEvent = new PaymentMethodChangeEvent(type, options);
Parameters
type
-
A
DOMString
which must contain the stringpaymentmethodchange
, the name of the only type of event which uses thePaymentMethodChangeEvent
interface. options
Optional-
An optional
PaymentMethodChangeEventInit
dictionary which may contain zero or more of the following properties:methodName
Optional-
A
DOMString
containing the payment method identifier for the payment handler being used. This is an empty string by default. methodDetails
Optional-
An object providing payment method-specific information describing the changes made to the payment, or
null
if there is no additional information available or required. This isnull
by default.
Return value
A newly-created PaymentMethodChangeEvent
object describing a change to
the options specified for the payment method given in the methodName
property.
The type of the methodDetails
property depends on the payment method. For
example, if methodName
is https://example.com/pay
, indicating that the
Example Pay payment method is being used for validation, the shape of methodDetails
is defined by the payment method.
Specifications
Specification |
---|
Payment Request API # dom-paymentmethodchangeevent-constructor |
Browser compatibility
BCD tables only load in the browser