Service Workers API
该参数传递到 ServiceWorkerGlobalScope.oninstall 事件处理程序,InstallEvent 接口表示一个 ServiceWorker 的 ServiceWorkerGlobalScope 上分派的安装操作。作为 ExtendableEvent 的一个子类,它确保在安装期间不调度诸如 FetchEvent 之类的功能事件。
该接口继承自 ExtendableEvent 接口。
构造函数
- InstallEvent.InstallEvent()
- : 创建一个新的
InstallEvent对象。
- : 创建一个新的
属性
从它的祖先Event继承属性。
- InstallEvent.activeWorker
- : 返回当前处于激活状态,控制页面的ServiceWorker。
方法
从它的父类ExtendableEvent继承方法。
示例
该代码片段来自 service worker prefetch sample (请参阅 prefetch running live)。代码在ServiceWorkerGlobalScope.oninstall中调用ExtendableEvent.waitUntil,并延迟将ServiceWorkerRegistration.installing worker 视为已安装的,直到传递的 promise 被成功地 resolve。当所有资源已经获取并缓存,或者有任何异常发生时,promise 才会 resolve。
该代码片段也展示了服务工作线程使用的缓存版本控制的最佳实践。虽然此示例只有一个缓存,但你可以将此方法用于多个缓存。代码将缓存的速记标识映射到特定的版本化缓存名称。
[!NOTE] service worker 的注册日志记录在 Chrome 浏览器中可以通过访问 chrome://serviceworker-internals 查看。
var CACHE_VERSION = 1;
var CURRENT_CACHES = {
prefetch: "prefetch-cache-v" + CACHE_VERSION,
};
self.addEventListener("install", function (event) {
var urlsToPrefetch = [
"./static/pre_fetched.txt",
"./static/pre_fetched.html",
"https://www.chromium.org/_/rsrc/1302286216006/config/customLogo.gif",
];
console.log(
"Handling install event. Resources to pre-fetch:",
urlsToPrefetch,
);
event.waitUntil(
caches
.open(CURRENT_CACHES["prefetch"])
.then(function (cache) {
cache
.addAll(
urlsToPrefetch.map(function (urlToPrefetch) {
return new Request(urlToPrefetch, { mode: "no-cors" });
}),
)
.then(function () {
console.log("All resources have been fetched and cached.");
});
})
.catch(function (error) {
console.error("Pre-fetching failed:", error);
}),
);
});
浏览器兼容性
参见
- NotificationEvent
- Promise
- Fetch API
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
