Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 Details seiner Versandadresse ändert.

Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergegeben.

Syntax

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

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

onshippingaddresschange = (event) => { }

Ereignistyp

Ein PaymentRequestUpdateEvent. Erbt von Event.

Event PaymentRequestUpdateEvent

Ereigniseigenschaften

Stellt nur die von Event geerbten Eigenschaften zur Verfügung.

Hinweise zur Verwendung

Abhängig vom Browser können Informationen zur Versandadresse aus Datenschutzgründen unkenntlich gemacht werden. Das heißt, der PaymentAddress, der die Versandadresse enthält, kann teilweise verändert, verdeckt oder vollständig weggelassen werden, um zu verhindern, dass der Benutzer ohne seine Zustimmung identifiziert wird (da Sie zum Versenden von Produkten an ihn seine Adresse benötigen).

Beispiel

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

js
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-Ereignisbehandlungseigenschaft festlegen:

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

Browser-Kompatibilität