ServiceWorkerRegistration.update()

ServiceWorkerRegistration インターフェースの update メソッドは、service work のアップデートを試行します。 worker の script URL を取得できた場合や新しい worker が現在の worker と byte-by-byte で識別できない場合、新しい worker をインストールします。以前の取得が 24 時間以上前だった場合、worker の取得はいずれかのブラウザーキャッシュをバイパスします。

構文

ServiceWorkerRegistration.update();

引数

なし。

戻り値

Void。

例

次のシンプルな例は、service worker 例を登録して、望むときに service worker を更新できるようにボタンのイベントハンドラを追加しています:

if ('serviceWorker' in navigator) {
  navigator.serviceWorker.register('/sw-test/sw.js', {scope: 'sw-test'}).then(function(registration) {
    // registration worked
    console.log('Registration succeeded.');
    button.onclick = function() {
      registration.update();
    }
  }).catch(function(error) {
    // registration failed
    console.log('Registration failed with ' + error);
  });
};

仕様

ブラウザー実装状況

• [1] Chrome 46 から、操作が成功した場合や更新がなかった場合、update() は 'undefined' で解決する promise を返します。更新が失敗した場合は reject します。インストールが失敗したが新しい worker が実行される場合、まだ promise が解決されます; 形式的には、例外が発生すべきです。
• [2] Chrome 48 以前では、このメソッドは常にブラウザーキャッシュをバイパスします。Chrome 48 から, worker の取得が 24 時間以上前だった場合のみ、ブラウザーキャッシュをバイパスします。
• [3] Service workers（と Push）は、Firefox 45 延長サポート版 （ESR）では使用できません。

関連項目

• Using Service Workers
• Service workers basic code example
• Is ServiceWorker ready?
• Promise
• Using web workers