PaymentRequestEvent: openWindow() method
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Note: This feature is only available in Service Workers.
The openWindow()
method of the PaymentRequestEvent
interface opens the specified URL in a new window, only if the given URL is on the same origin as the calling page. It returns a Promise
that resolves with a reference to a WindowClient
.
Syntax
js
openWindow(url)
Parameters
url
-
The URL to open in the new window. It must be on the same origin as the calling page.
Return value
A Promise
that resolves with a reference to a
WindowClient
.
Examples
js
…
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 'Failed to open window';
}
} catch (err) {
// Reject the promise on failure
resolver.reject(err);
};
});
…
See Open the payment handler window to display the web-based payment app frontend for more details about how this would be used.
Specifications
Specification |
---|
Payment Handler API # dom-paymentrequestevent-openwindow |
Browser compatibility
BCD tables only load in the browser