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 und befindet sich nicht auf dem Weg zur Standardisierung. Verwenden Sie sie nicht auf Produktionsseiten, die dem Web ausgesetzt sind: Sie funktioniert nicht für alle Benutzer. Es kann auch große Inkompatibilitäten zwischen Implementierungen geben, und das Verhalten kann sich in Zukunft ändern.

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