PaymentMethodChangeEvent: PaymentMethodChangeEvent() constructor
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
new PaymentMethodChangeEvent(type)
new PaymentMethodChangeEvent(type, options)
Parameters
type-
A string with the name of the event. It is case-sensitive and browsers set it to
paymentmethodchange. optionsOptional-
An object that, in addition of the properties defined in
Event(), can have the following properties:methodNameOptional-
A string containing the payment method identifier for the payment handler being used. This is an empty string by default.
methodDetailsOptional-
An object providing payment method-specific information describing the changes made to the payment, or
nullif there is no additional information available or required. This isnullby default.
Return value
A new 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 1.1 # dom-paymentmethodchangeevent-constructor |
Browser compatibility
BCD tables only load in the browser