ServiceWorkerContainer.getRegistration()

getRegistration() は ServiceWorkerContainer インターフェイスのメソッドで、スコープ URL が指定された文書の URL と一致する ServiceWorkerRegistration オブジェクトを取得します。 このメソッドは、ServiceWorkerRegistration または undefined に解決される Promise を返します。

構文

getRegistration()
getRegistration(clientURL)

引数

clientURL 省略可

この URL に照合するスコープを持つ登録が返されます。関連の URL は、現在のクライアントを基点として解決されます。この引数が指定されなかった場合、既定では現在のクライアントの URL が使用されます。

返値

ServiceWorkerRegistration オブジェクトまたは undefined に解決される Promise です。

例

navigator.serviceWorker.getRegistration('/app').then((registration) => {
  if (registration) {
    document.querySelector('#status').textContent = 'ServiceWorkerRegistration が見つかりました。';
  }
});

仕様書

Specification
Service Workers
# navigator-service-worker-getRegistration

ブラウザーの互換性

BCD tables only load in the browser