ServiceWorkerContainer: getRegistration() 方法

Baseline 已廣泛支援

此功能已成熟,可跨多種裝置和瀏覽器版本工作。它自 ⁨2018 年 4 月⁩ 起已在所有瀏覽器中可用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

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

ServiceWorkerContainer 介面的 getRegistration() 方法獲取一個 ServiceWorkerRegistration 物件,該物件的 scope URL 與所提供的客戶端 URL 匹配。該方法返回一個 Promise,它解析為一個 ServiceWorkerRegistration 物件或 undefined

語法

js
getRegistration()
getRegistration(clientURL)

引數

clientURL 可選

將返回 scope 與此 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

瀏覽器相容性