PaymentRequest.onshippingaddresschange
Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Deprecated
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The onshippingaddresschange event of the
PaymentRequest interface is fired whenever the user changes their
shipping address, including when an address is added by the user for the first time.
Syntax
PaymentRequest.addEventListener('shippingaddresschange', shippingAddressChangeEvent => { ... });
PaymentRequest.onshippingaddresschange = function(shippingAddressChangeEvent) { ... };Examples
The shippingaddresschange event is triggered by a user-agent controlled
interaction. If the address stored by the user agent changes at any time during a
payment process, the event is triggered. To make sure an updated address is included
when sending payment information to the server, you should add event listeners for a
PaymentRequest object after instantiation, but before the call
to show().
// Initialization of PaymentRequest arguments are excerpted for clarity.
var payment = new PaymentRequest(supportedInstruments, details, options);
request.addEventListener('shippingaddresschange', function(evt) {
evt.updateWith(new Promise(function(resolve) {
updateDetails(details, request.shippingAddress, resolve);
}));
});
payment.show().then(function(paymentResponse) {
// Processing of paymentResponse exerpted for the same of clarity.
}).catch(function(err) {
console.error("Uh oh, something bad happened", err.message);
});
Browser compatibility
BCD tables only load in the browser