PaymentRequest: shippingaddresschange-Ereignis
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Das shippingaddresschange-Ereignis wird an das PaymentRequest-Objekt gesendet, wenn der Benutzer eine Versandadresse auswählt oder die Details seiner Versandadresse ändert.
Dieses Ereignis kann nicht abgebrochen werden und tritt nicht in eine Blasenphase ein.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("shippingaddresschange", (event) => { })
onshippingaddresschange = (event) => { }
Ereignistyp
Ein PaymentRequestUpdateEvent. Erbt von Event.
Nutzungshinweise
Je nach Browser können die Informationen zur Versandadresse aus Datenschutzgründen gekürzt werden. Das heißt, die PaymentAddress, die die Versandadresse enthält, kann Teile ihres Inhalts verändert, verdeckt oder vollständig ausgelassen haben, um eine Identifizierung des Benutzers ohne seine Zustimmung zu verhindern (da Sie, wenn sie sich entscheiden, dass Sie Produkte an sie versenden, ihre Adresse benötigen).
Beispiel
In diesem Beispiel wird ein Handler für das shippingaddresschange-Ereignis eingerichtet, um zu überprüfen, dass die Adresse die vom Webanwendung festgelegten Anforderungen erfüllt.
const paymentRequest = new PaymentRequest(methodData, details, options);
paymentRequest.addEventListener("shippingaddresschange", (event) => {
const detailsUpdate = checkAddress(paymentRequest.shippingAddress);
event.updateWith(detailsUpdate);
});
function checkAddress(theAddress) {
const detailsUpdate = {};
// Check the address, return an object with any changes or errors.
return detailsUpdate;
}
Sie können auch einen Handler für shippingaddresschange mit der onshippingaddresschange-Ereignis-Handler-Eigenschaft einrichten:
paymentRequest.onshippingaddresschange = (event) => {
const detailsUpdate = checkAddress(paymentRequest.shippingAddress);
event.updateWith(detailsUpdate);
};