ServiceWorkerGlobalScope
接口在
服务工作者 API
represents the global execution context of a service worker.
Developers should keep in mind that the ServiceWorker state is not persisted across the termination/restart cycle, so each event handler should assume it's being invoked with a bare, default global state.
Once successfully registered, a service worker can and will be terminated when idle to conserve memory and processor power. An active service worker is automatically restarted to respond to events, such as
ServiceWorkerGlobalScope.onfetch
or
ServiceWorkerGlobalScope.onmessage
.
Additionally, synchronous requests are not allowed from within a service worker — only asynchronous requests, like those initiated via the
fetch()
method, can be used.
This interface inherits from the
WorkerGlobalScope
interface, and its parent
EventTarget
, and therefore implements properties from
WindowTimers
,
WindowBase64
，和
WindowEventHandlers
.
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 12.142857142857142%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-20 0 700 85" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/WorkerGlobalScope" target="_top"><rect x="151" y="1" width="170" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="236" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">WorkerGlobalScope</text></a><polyline points="321,25 331,20 331,30 321,25" stroke="#D4DDE4" fill="none"/><line x1="331" y1="25" x2="361" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/ServiceWorkerGlobalScope" target="_top"><rect x="361" y="1" width="240" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="481" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">ServiceWorkerGlobalScope</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
ServiceWorkerGlobalScope.caches
只读
CacheStorage
object associated with the service worker.
ServiceWorkerGlobalScope.clients
只读
Clients
object associated with the service worker.
ServiceWorkerGlobalScope.registration
只读
ServiceWorkerRegistration
object that represents the service worker's registration.
activate
ServiceWorkerRegistration
acquires a new
ServiceWorkerRegistration.active
worker.
ServiceWorkerGlobalScope.onactivate
特性。
contentdelete
Content Index
.
ServiceWorkerGlobalScope.oncontentdelete
特性。
fetch
fetch()
被调用。
ServiceWorkerGlobalScope.onfetch
特性。
安装
ServiceWorkerRegistration
acquires a new
ServiceWorkerRegistration.installing
worker.
ServiceWorkerGlobalScope.oninstall
特性。
message
MessagePort.postMessage()
method to send messages to service workers. The service worker can optionally send a response back via the
MessagePort
exposed in
event.data.port
, corresponding to the controlled page.
ServiceWorkerGlobalScope.onmessage
特性。
notificationclick
ServiceWorkerGlobalScope.onnotificationclick
特性。
notificationclose
ServiceWorkerGlobalScope.onnotificationclose
特性。
push
ServiceWorkerGlobalScope.onpush
特性。
pushsubscriptionchange
ServiceWorkerGlobalScope.onpushsubscriptionchange
特性。
sync
SyncManager.register
is made from a service worker client page. The attempt to sync is made either immediately if the network is available or as soon as the network becomes available.
ServiceWorkerGlobalScope.onsync
特性。
ServiceWorkerGlobalScope.skipWaiting()
Allows the current service worker registration to progress from waiting to active state while service worker clients are using it.
ServiceWorkerGlobalScope
实现
WorkerGlobalScope
— which implements
WindowOrWorkerGlobalScope
. Therefore it also has the following property available to it:
GlobalFetch.fetch()
响应
object representing the response to your request. This algorithm is the entry point for the fetch handling handed to the service worker context.
This code snippet is from the
service worker prefetch sample
(见
prefetch example live
.) The
ServiceWorkerGlobalScope.onfetch
event handler listens for the
fetch
event. When fired, the code returns a promise that resolves to the first matching request in the
缓存
object. If no match is found, the code fetches a response from the network.
The code also handles exceptions thrown from the
fetch()
operation. Note that an HTTP error response (e.g., 404) will not trigger an exception. It will return a normal response object that has the appropriate error code set.
self.addEventListener('fetch', function(event) {
console.log('Handling fetch event for', event.request.url);
event.respondWith(
caches.match(event.request).then(function(response) {
if (response) {
console.log('Found response in cache:', response);
return response;
}
console.log('No response found in cache. About to fetch from network...');
return fetch(event.request).then(function(response) {
console.log('Response from network is:', response);
return response;
}, function(error) {
console.error('Fetching failed:', error);
throw error;
});
})
);
});
| 规范 | 状态 | 注释 |
|---|---|---|
|
服务工作者
The definition of 'ServiceWorkerGlobalScope' in that specification. |
工作草案 | 初始定义 |
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
ServiceWorkerGlobalScope
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
activate
event
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
caches
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
clients
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
安装
event
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
message
event
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
notificationclick
event
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android No | Chrome Android 40 | Firefox Android 44 | Opera Android 27 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
onabortpayment
|
Chrome
61
Disabled
|
Edge
≤79
Disabled
|
Firefox ? | IE No | Opera ? | Safari 11.1 | WebView Android No |
Chrome Android
61
Disabled
|
Firefox Android ? | Opera Android ? | Safari iOS 11.3 | Samsung Internet Android No |
onactivate
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
onbackgroundfetchabort
|
Chrome 74 | Edge No | Firefox No | IE No | Opera 62 | Safari No | WebView Android No | Chrome Android 74 | Firefox Android No | Opera Android 53 | Safari iOS No | Samsung Internet Android 11.0 |
onbackgroundfetchclick
|
Chrome 74 | Edge No | Firefox No | IE No | Opera 62 | Safari No | WebView Android No | Chrome Android 74 | Firefox Android No | Opera Android 53 | Safari iOS No | Samsung Internet Android 11.0 |
onbackgroundfetchfail
|
Chrome 74 | Edge No | Firefox No | IE No | Opera 62 | Safari No | WebView Android No | Chrome Android 74 | Firefox Android No | Opera Android 53 | Safari iOS No | Samsung Internet Android 11.0 |
onbackgroundfetchsuccess
|
Chrome 74 | Edge No | Firefox No | IE No | Opera 62 | Safari No | WebView Android No | Chrome Android 74 | Firefox Android No | Opera Android 53 | Safari iOS No | Samsung Internet Android 11.0 |
oncanmakepayment
|
Chrome
61
Disabled
|
Edge
≤79
Disabled
|
Firefox ? | IE No | Opera ? | Safari ? | WebView Android No |
Chrome Android
61
Disabled
|
Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android No |
onfetch
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
oninstall
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
onmessage
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
onmessageerror
|
Chrome ? | Edge ? | Firefox ? | IE No | Opera ? | Safari ? | WebView Android ? | Chrome Android ? | Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android ? |
onnotificationclick
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
onnotificationclose
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
onpaymentrequest
|
Chrome
57
Disabled
|
Edge
≤79
Disabled
|
Firefox ? | IE No | Opera ? | Safari ? | WebView Android No |
Chrome Android
57
Disabled
|
Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android No |
onpush
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
onpushsubscriptionchange
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
onsync
|
Chrome 49 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 49 | Chrome Android 49 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 5.0 |
push
event
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
pushsubscriptionchange
event
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
registration
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari 11.1 | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS 11.3 | Samsung Internet Android 4.0 |
skipWaiting
|
Chrome 40 | Edge ≤79 |
Firefox
44
|
IE No | Opera 24 | Safari No | WebView Android 40 | Chrome Android 40 | Firefox Android 44 | Opera Android 24 | Safari iOS No | Samsung Internet Android 4.0 |
完整支持
不支持
兼容性未知
实验。期望将来行为有所改变。
见实现注意事项。
用户必须明确启用此特征。
ServiceWorkerGlobalScope