ServiceWorkerContainer:getRegistration() 方法

安全上下文:此功能仅在安全上下文(HTTPS)中可用,在某些或所有支持的浏览器中。

注意:此功能在Web Workers中可用。

getRegistration() 方法是 ServiceWorkerContainer 接口的方法,它获取一个 ServiceWorkerRegistration 对象,该对象的范围 URL 与提供的客户端 URL 匹配。该方法返回一个 Promise,该 Promise 解析为一个 ServiceWorkerRegistrationundefined

语法

js
getRegistration()
getRegistration(clientURL)

参数

clientURL 可选

将返回范围与该 URL 匹配的注册。相对 URL 将以当前客户端作为基础进行解析。如果未提供此参数,则默认使用当前客户端的 URL。

返回值

一个 Promise,它解析为一个 ServiceWorkerRegistration 对象或 undefined

示例

js
navigator.serviceWorker.getRegistration("/app").then((registration) => {
  if (registration) {
    document.querySelector("#status").textContent =
      "ServiceWorkerRegistration found.";
  }
});

规范

规范
Service Workers
# navigator-service-worker-getRegistration

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。