PeriodicSyncManager: register() 方法
注意:此功能在 Web Workers 中可用。
register() 方法是 PeriodicSyncManager 接口的一部分,它使用指定的标签和选项向浏览器注册一个周期性同步请求。它返回一个 Promise,该 Promise 在注册完成时解析。
语法
js
register(tag, options)
参数
tag-
一个唯一的
String标识符。 options可选-
一个包含以下可选数据的
ObjectminInterval-
周期性同步应该发生的最小间隔时间(以毫秒为单位)。
返回值
异常
InvalidStateErrorDOMException-
如果没有活动的
ServiceWorker,则返回此值。 NotAllowedErrorDOMException-
如果未授予后台周期性同步的权限,则返回此值。
InvalidAccessErrorDOMException-
如果活动窗口不是主窗口(不是
auxiliary或top-level类型),则返回此值。
示例
以下异步函数将在浏览上下文中,以一天为最短间隔,注册一次周期性后台同步。
js
async function registerPeriodicNewsCheck() {
const registration = await navigator.serviceWorker.ready;
try {
await registration.periodicSync.register("fetch-news", {
minInterval: 24 * 60 * 60 * 1000,
});
} catch {
console.log("Periodic Sync could not be registered!");
}
}
规范
| 规范 |
|---|
| Web 周期性后台同步 # dom-periodicsyncmanager-register |
浏览器兼容性
加载中…