此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
Clients.claim()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2018年4月.
Clients 接口的 claim() 方法允许一个激活的 service worker 将自己设置为其 scope 内所有 clients 的controller . 这会在由此 service worker 控制的任何 clients 中触发 navigator.serviceWorker 上的 "controllerchange" 事件。
当一个 service worker 被初始注册时,页面在下次加载之前不会使用它。 claim() 方法会立即控制这些页面。请注意,这会导致 service worker 控制通过网络定期加载的页面,或者可能通过不同的 service worker 加载。
语法
await clients.claim();
参数
None.
返回
A Promise for void.
示例
The following example uses claim() inside service worker's "activate" event listener so that clients loaded in the same scope do not need to be reloaded before their fetches will go through this service worker.
js
self.addEventListener("activate", (event) => {
event.waitUntil(clients.claim());
});
规范
| Specification |
|---|
| Service Workers # clients-claim |
浏览器兼容性
Loading...
参见
- 使用 Service Worker
- service worker 的生命周期
self.skipWaiting()——跳过 service worker 的等待阶段