PaymentRequestEvent: openWindow() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Hinweis: Diese Funktion ist nur in Service Workers verfügbar.

Die openWindow() Methode des PaymentRequestEvent-Interfaces öffnet die angegebene URL in einem neuen Fenster, jedoch nur, wenn die angegebene URL denselben Ursprung wie die aufrufende Seite hat. Sie gibt ein Promise zurück, das mit einer Referenz auf einen WindowClient aufgelöst wird.

Syntax

openWindow(url)

Parameter

url: Die URL, die in einem neuen Fenster geöffnet werden soll. Sie muss denselben Ursprung haben wie die aufrufende Seite.

Rückgabewert

Ein Promise, das mit einer Referenz auf einen WindowClient aufgelöst wird.

Beispiele

self.addEventListener("paymentrequest", async (e) => {
  // …
  // Retain a promise for future resolution
  // Polyfill for PromiseResolver at link below.
  resolver = new PromiseResolver();

  // Pass a promise that resolves when payment is done.
  e.respondWith(resolver.promise);
  // Open the checkout page.
  try {
    // Open the window and preserve the client
    client = await e.openWindow(checkoutURL);
    if (!client) {
      // Reject if the window fails to open
      throw new Error("Failed to open window");
    }
  } catch (err) {
    // Reject the promise on failure
    resolver.reject(err);
  }
});

Siehe Öffnen des Zahlungsabwickler-Fensters zur Anzeige der webbasierten Zahlungsanwendung-Vorderseite für weitere Details zur Anwendung dieser Funktion.

Spezifikationen

Specification
Payment Handler API # dom-paymentrequestevent-openwindow