大网数据广告活动
Web 标准与前端开发

Clients.openWindow()

· 52CE 我爱测

Clients接口的 **`openWindow()`** 方法创建一个顶级的浏览器上下文并加载给定的 URL. 如果调用脚本没有显示弹出窗口的权限, **`openWindow()`** 将抛出 InvalidAccessError.

Service Workers 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
    • : 一个 String,表示要在窗口中打开的 client 的 URL。通常,此值必须是与调用脚本有相同域的 URL.

返回值

如果 URL 来自与服务工作者相同的域,则 resolve 为 WindowClient 对象的 Promise,否则 resolve 为 null.

示例

// 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.
      });
    }
  });
};

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。