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 Lieferadresse auswählt oder Details seiner Lieferadresse ändert.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergeleitet.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

js
addEventListener("shippingaddresschange", (event) => { })

onshippingaddresschange = (event) => { }

Ereignistyp

Ein PaymentRequestUpdateEvent. Erbt von Event.

Event PaymentRequestUpdateEvent

Ereigniseigenschaften

Bietet nur die von Event geerbten Eigenschaften.

Hinweise zur Verwendung

Abhängig vom Browser können die Informationen zur Lieferadresse aus Datenschutzgründen unkenntlich gemacht werden. Das bedeutet, dass die PaymentAddress, die die Lieferadresse enthält, möglicherweise einige Teile ihres Inhalts verändert, verdeckt oder vollständig weggelassen werden, um eine Identifizierung des Benutzers ohne seine Zustimmung zu verhindern (da Sie, wenn sie entscheiden, dass Sie Produkte an sie versenden sollen, ihre Adresse benötigen).

Beispiel

In diesem Beispiel wird ein Handler für das shippingaddresschange Ereignis eingerichtet, um zu überprüfen, ob die Adresse die vom Webanwendung festgelegten Anforderungen erfüllt.

js
const paymentRequest = new PaymentRequest(methodData, details, options);

paymentRequest.addEventListener(
  "shippingaddresschange",
  (event) => {
    let detailsUpdate = checkAddress(paymentRequest.shippingAddress);
    event.updateWith(detailsUpdate);
  },
  false,
);

const checkAddress = (theAddress) => {
  let detailsUpdate = {};

  // Check the address, return an object with any changes or errors.

  return detailsUpdate;
};

Sie können auch einen Handler für shippingaddresschange über die onshippingaddresschange Ereignis-Handler-Eigenschaft einrichten:

js
paymentRequest.onshippingaddresschange = (event) => {
  let detailsUpdate = checkAddress(paymentRequest.shippingAddress);
  event.updateWith(detailsUpdate);
};

Browser-Kompatibilität