Clients.openWindow()
Experimental: 这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
Clients
接口的 openWindow()
方法创建一个顶级的浏览器上下文并加载给定的 URL. 如果调用脚本没有显示弹出窗口的权限, openWindow()
将抛出 InvalidAccessError.
在 Firefox 中,只有在作为通知点击事件的结果调用时,才允许该方法显示弹出窗口。
在 Chrome for Android 中,该方法可以改为在先前添加到用户主屏幕的 standalone web app 提供的现有浏览上下文中打开 URL.
语法
ServiceWorkerClients.openWindow(url).then(function(WindowClient) {
// do something with your WindowClient
});
参数
url
-
一个
USVString
,表示要在窗口中打开的 client 的 URL。通常,此值必须是与调用脚本有相同域的 URL.
返回值
如果 URL 来自与服务工作者相同的域,则 resolve 为 WindowClient
对象的 Promise,否则 resolve 为 null value.
示例
// When the user clicks a notification focus the window if it exists or open
// a new one otherwise.
onotificationclick = function(event) {
var found = false;
clients.matchAll().then(function(clientsArr) {
for (i = 0; i < clientsArr.length; i++) {
if (clientsArr[i].url === event.data.url) {
// We already have a window to use, focus it.
found = true;
clientsArr[i].focus();
break;
}
}
if (!found) {
// Create a new window.
clients.openWindow(event.data.url).then(function(windowClient) {
// do something with the windowClient.
});
}
});
};
规范
Specification |
---|
Service Workers # clients-openwindow |
浏览器兼容性
BCD tables only load in the browser