Clients.openWindow() - Web API 接口参考 编辑

这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

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	Status	Comment
Service Workers Clients	Working Draft	Initial definition.

浏览器兼容性

BCD tables only load in the browser

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.