From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../serviceworkerregistration/active/index.html | 70 ++++++++++ .../getnotifications/index.html | 77 +++++++++++ .../web/api/serviceworkerregistration/index.html | 148 +++++++++++++++++++++ .../installing/index.html | 61 +++++++++ .../navigationpreload/index.html | 48 +++++++ .../onupdatefound/index.html | 56 ++++++++ .../periodicsync/index.html | 44 ++++++ .../pushmanager/index.html | 80 +++++++++++ .../api/serviceworkerregistration/scope/index.html | 56 ++++++++ .../shownotification/index.html | 106 +++++++++++++++ .../api/serviceworkerregistration/sync/index.html | 48 +++++++ .../unregister/index.html | 82 ++++++++++++ .../serviceworkerregistration/update/index.html | 81 +++++++++++ .../serviceworkerregistration/waiting/index.html | 63 +++++++++ 14 files changed, 1020 insertions(+) create mode 100644 files/ja/web/api/serviceworkerregistration/active/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/getnotifications/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/installing/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/navigationpreload/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/onupdatefound/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/periodicsync/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/pushmanager/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/scope/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/shownotification/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/sync/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/unregister/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/update/index.html create mode 100644 files/ja/web/api/serviceworkerregistration/waiting/index.html (limited to 'files/ja/web/api/serviceworkerregistration') diff --git a/files/ja/web/api/serviceworkerregistration/active/index.html b/files/ja/web/api/serviceworkerregistration/active/index.html new file mode 100644 index 0000000000..e615ade109 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/active/index.html @@ -0,0 +1,70 @@ +--- +title: ServiceWorkerRegistration.active +slug: Web/API/ServiceWorkerRegistration/active +tags: + - API + - Property + - Reference + - Service Workers + - ServiceWorkerRegistration + - active +translation_of: Web/API/ServiceWorkerRegistration/active +--- +
{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの active プロパティは、{{domxref("ServiceWorker.state")}} がアクティブ化中（activating）またはアクティブ化済み（activated）のサービスワーカーを返します。 このプロパティは、最初は null に設定されています。

+ +

クライアントの URL が登録のスコープ内にある場合、アクティブワーカーは {{domxref("ServiceWorkerClient")}} を制御します（{{domxref("ServiceWorkerContainer.register")}} が最初に呼び出されたときに設定された scope オプション）。

+ +
+

注: この機能は Web Worker で使用できます。

+
+ +
+

注: アクティブワーカーが activating になると、ランタイムスクリプトエラーもアクティブワーカーの強制終了もアクティブワーカーが activated になることを妨げません。

+
+ +

構文

+ +
var serviceWorker = serviceWorkerRegistration.active;
+
+ +

値

+ +

{{domxref("ServiceWorker")}} オブジェクトのプロパティ（現在アクティブ化中（activating）またはアクティブ化済み（activated）の状態の場合）。

+ +

仕様

+ +
+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Service Workers', '#dom-serviceworkerregistration-active', 'ServiceWorkerRegistration.active')}}{{Spec2('Service Workers')}}初期定義
+  
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.active")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/serviceworkerregistration/getnotifications/index.html b/files/ja/web/api/serviceworkerregistration/getnotifications/index.html new file mode 100644 index 0000000000..f2da1b2832 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/getnotifications/index.html @@ -0,0 +1,77 @@ +--- +title: ServiceWorkerRegistration.getNotifications() +slug: Web/API/ServiceWorkerRegistration/getNotifications +tags: + - API + - Experimental + - Method + - Notification + - Notifications + - Reference + - Service Worker + - Service Workers + - Service worker API + - ServiceWorker + - ServiceWorkerRegistration + - getNotifications +translation_of: Web/API/ServiceWorkerRegistration/getNotifications +--- +
{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの getNotifications() メソッドは、現在のサービスワーカー登録を介して現在のオリジンから作成された順序で通知のリストを返します。 オリジンには、アクティブではあるがスコープが異なるサービスワーカー登録が多数あります。 同じオリジンの1つのサービスワーカーによって作成された通知は、同じオリジンの他のアクティブなサービスワーカーでは利用できません。

+ +

構文

+ +
s​erviceWorkerRegistration.getNotifications(options)
+.then(function(notificationsList) { ... });
+ +

パラメーター

+ +
+
options {{optional_inline}}
+
返される通知をフィルタするオプションを含むオブジェクト。 使用可能なオプションは次のとおりです。 +
    +
  • tag: 通知タグを表す {{domxref("DOMString")}}。 指定した場合、このタグを持つ通知のみが返されます。
    • +
+
+
+ +

戻り値

+ +

{{domxref("Notification")}} オブジェクトのリストに解決される {{jsxref("Promise")}}。
+  

+ +

例

+ +
navigator.serviceWorker.register('sw.js');
+
+var options = { tag : 'user_alerts' };
+
+navigator.serviceWorker.ready.then(function(registration) {
+  registration.getNotifications(options).then(function(notifications) {
+    // notifications で何かをします
+  })
+});
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Web Notifications', '#dom-serviceworkerregistration-getnotifications', 'ServiceWorkerRegistration.getNotifications()')}}{{Spec2('Web Notifications')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.getNotifications")}}

diff --git a/files/ja/web/api/serviceworkerregistration/index.html b/files/ja/web/api/serviceworkerregistration/index.html new file mode 100644 index 0000000000..51cfcce789 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/index.html @@ -0,0 +1,148 @@ +--- +title: ServiceWorkerRegistration +slug: Web/API/ServiceWorkerRegistration +tags: + - API + - Interface + - Offline + - Reference + - Service Workers + - Service worker API + - ServiceWorkerRegistration + - Workers +translation_of: Web/API/ServiceWorkerRegistration +--- +
+
{{APIRef("Service Workers API")}}
+
+ +

Service Worker API の ServiceWorkerRegistration インターフェイスは、サービスワーカー登録を表します。 あなたは同じオリジンを共有する1つ以上のページを制御するサービスワーカーを登録します。

+ +

サービスワーカー登録の存続期間は、対応するサービスワーカークライアントの存続期間内でそれらを表す ServiceWorkerRegistration オブジェクトの存続期間を超えています。 ブラウザーは、アクティブな ServiceWorkerRegistration オブジェクトの永続的なリストを維持します。

+ +
+

注: この機能は Web Worker で使用できます。

+
+ +

プロパティ

+ +

また、その親インターフェイスである {{domxref("EventTarget")}} からプロパティを実装します。

+ +
+
{{domxref("ServiceWorkerRegistration.scope")}} {{readonlyinline}}
+
サービスワーカー登録の一意の識別子を返します。 これは、{{domxref("ServiceWorker")}} を登録する文書と同じオリジンにある必要があります。
+
{{domxref("ServiceWorkerRegistration.installing")}} {{readonlyinline}}
+
状態がインストール中（installing）のサービスワーカーを返します。 これは最初は null に設定されています。
+
{{domxref("ServiceWorkerRegistration.waiting")}} {{readonlyinline}}
+
状態がインストール済み（installed）のサービスワーカーを返します。 これは最初は null に設定されています。
+
{{domxref("ServiceWorkerRegistration.active")}} {{readonlyinline}}
+
状態がアクティブ化中（activating）またはアクティブ化済み（activated）のサービスワーカーを返します。 これは最初は null に設定されています。 クライアントの URL が登録のスコープ内にある場合、アクティブワーカーは {{domxref("ServiceWorkerClient")}} を制御します（{{domxref("ServiceWorkerContainer.register")}} を最初に呼び出したときに設定した scope オプション）。
+
{{domxref("ServiceWorkerRegistration.navigationPreload")}} {{readonlyinline}}
+
現在のサービスワーカー登録に関連する {{domxref("NavigationPreloadManager")}} のインスタンスを返します。
+
{{domxref("ServiceWorkerRegistration.pushManager")}} {{readonlyinline}}
+
購読申し込み、アクティブな購読の取得、プッシュの許可状況へのアクセスなど、プッシュの購読を管理するための {{domxref("PushManager")}} インターフェイスへの参照を返します。
+
{{domxref("ServiceWorkerRegistration.sync")}} {{non-standard_inline}} {{readonlyinline}}
+
バックグラウンド同期プロセスを管理する {{domxref("SyncManager")}} インターフェイスへの参照を返します。
+
+ +

未実装プロパティ

+ +
+
{{domxref("serviceWorkerRegistration.periodicSync")}} {{non-standard_inline}} {{readonlyinline}}
+
定期的なバックグラウンド同期プロセスを管理する {{domxref("PeriodicSyncManager")}} インターフェイスへの参照を返します。 これは、ある時点でサービスワーカーの説明でアイデアとして言及されましたが、まだどこにも実装されていません。
+
+ +

イベントハンドラー

+ +
+
{{domxref("ServiceWorkerRegistration.onupdatefound")}} {{readonlyinline}}
+
タイプが updatefound のイベントが発生するたびに呼び出される EventListener のプロパティ。 {{domxref("ServiceWorkerRegistration.installing")}} プロパティが新しいサービスワーカーを取得するたびに発生します。
+
+ +

メソッド

+ +

また、その親インターフェースである {{domxref("EventTarget")}} からメソッドを実装します。

+ +
+
{{domxref("ServiceWorkerRegistration.getNotifications()")}}
+
{{domxref("Notification")}} オブジェクトの配列に解決される {{jsxref("Promise")}} を返します。
+
{{domxref("ServiceWorkerRegistration.showNotification()")}}
+
要求したタイトルの通知を表示します。
+
{{domxref("ServiceWorkerRegistration.update()")}}
+
サービスワーカーの更新されたバージョンを、キャッシュを調べずに、サーバーでチェックします。
+
{{domxref("ServiceWorkerRegistration.unregister()")}}
+
サービスワーカー登録を解除し、{{jsxref("Promise")}} を返します。 サービスワーカーは、登録が解除される前に進行中の操作を完了します。
+
+ +

例

+ +

この例では、コードはまずブラウザーがサービスワーカーをサポートしているかどうかをチェックし、サポートしている場合はそれを登録します。 次に、updatefound リスナーを追加します。 このリスナーでは、サービスワーカー登録を使用して、サービスワーカーの状態のさらなる変更をリッスンします。 サービスワーカーが最後に登録されてから変更されていない場合、updatefound イベントは発生しません。

+ +
if ('serviceWorker' in navigator) {
+  navigator.serviceWorker.register('/sw.js')
+  .then(function(registration) {
+    registration.addEventListener('updatefound', function() {
+      // updatefound が発生した場合は、新しいサービスワーカーを
+      // インストールしていることを意味します。
+      var installingWorker = registration.installing;
+      console.log('新しいサービスワーカーをインストールしています:',
+        installingWorker);
+
+      // インストール中のサービスワーカーの状態の変更を、
+      // installingWorker.onstatechange を介してリッスンできます
+    });
+  })
+  .catch(function(error) {
+    console.log('サービスワーカーの登録に失敗しました:', error);
+  });
+} else {
+  console.log('サービスワーカーをサポートしていません。');
+}
+ +

仕様

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Service Workers', '#serviceworkerregistration', 'ServiceWorkerRegistration')}}{{Spec2('Service Workers')}}初期定義
{{SpecName('Push API', '#dom-serviceworkerregistration-pushmanager', 'PushManager')}}{{Spec2('Push API')}}{{domxref("PushManager","pushManager")}} プロパティを追加。
{{SpecName('Web Notifications')}}{{Spec2('Web Notifications')}}{{domxref("ServiceWorkerRegistration.showNotification()","showNotification()")}} メソッドと {{domxref("ServiceWorkerRegistration.getNotifications()","getNotifications()")}} メソッドを追加。
{{SpecName('Background Sync')}}{{Spec2('Background Sync')}}{{domxref("ServiceWorkerRegistration.sync","sync")}} プロパティを追加。
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/serviceworkerregistration/installing/index.html b/files/ja/web/api/serviceworkerregistration/installing/index.html new file mode 100644 index 0000000000..f94497b628 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/installing/index.html @@ -0,0 +1,61 @@ +--- +title: ServiceWorkerRegistration.installing +slug: Web/API/ServiceWorkerRegistration/installing +tags: + - API + - Installing + - Property + - Reference + - Service Workers + - ServiceWorkerRegistration +translation_of: Web/API/ServiceWorkerRegistration/installing +--- +
{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの installing プロパティは、{{domxref("ServiceWorker.state")}} がインストール中（installing）のサービスワーカーを返します。 このプロパティは、最初は null に設定されています。

+ +
+

注: この機能は Web Worker で使用できます。

+
+ +

構文

+ +
var serviceWorker = serviceWorkerRegistration.installing;
+
+ +

値

+ +

{{domxref("ServiceWorker")}} オブジェクト（現在インストール中（installing）の状態の場合）。

+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Service Workers', '#dom-serviceworkerregistration-installing', 'ServiceWorkerRegistration.installing')}}{{Spec2('Service Workers')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.installing")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/serviceworkerregistration/navigationpreload/index.html b/files/ja/web/api/serviceworkerregistration/navigationpreload/index.html new file mode 100644 index 0000000000..a898e6ced6 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/navigationpreload/index.html @@ -0,0 +1,48 @@ +--- +title: ServiceWorkerRegistration.navigationPreload +slug: Web/API/ServiceWorkerRegistration/navigationPreload +tags: + - API + - NavigationPreloadManager + - Offline + - Property + - Service Workers + - ServiceWorkerRegistration + - Workers + - navigationPreload +translation_of: Web/API/ServiceWorkerRegistration/navigationPreload +--- +

{{APIRef("Service Workers API")}}

+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの navigationPreload 読み取り専用プロパティは、現在のサービスワーカー登録に関連する {{domxref("NavigationPreloadManager")}} を返します。

+ +

構文

+ +
var navigationPreloadManager = serviceWorkerRegistration.navigationPreload;
+ +

値

+ +

{{domxref("NavigationPreloadManager")}} のインスタンス。

+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Service Workers','#service-worker-registration-navigationpreload','navigationPreload')}}{{Spec2('Service Workers')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.navigationPreload")}}

diff --git a/files/ja/web/api/serviceworkerregistration/onupdatefound/index.html b/files/ja/web/api/serviceworkerregistration/onupdatefound/index.html new file mode 100644 index 0000000000..baea4f2581 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/onupdatefound/index.html @@ -0,0 +1,56 @@ +--- +title: ServiceWorkerRegistration.onupdatefound +slug: Web/API/ServiceWorkerRegistration/onupdatefound +tags: + - API + - Property + - Reference + - Service Workers + - ServiceWorkerRegistration + - onupdatefound +translation_of: Web/API/ServiceWorkerRegistration/onupdatefound +--- +
{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの onupdatefound プロパティは、statechange 型のイベントが発生するたびに呼び出される {{domxref("EventListener")}} プロパティです。 {{domxref("ServiceWorkerRegistration.installing")}} プロパティが新しいサービスワーカーを取得するたびに発生します。

+ +
+

注: この機能は Web Worker で使用できます。

+
+ +

構文

+ +
serviceWorkerRegistration.onupdatefound = function() { ... };
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Service Workers', '#dom-serviceworkerregistration-onupdatefound', 'ServiceWorkerRegistration.onupdatefound')}}{{Spec2('Service Workers')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.onupdatefound")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/serviceworkerregistration/periodicsync/index.html b/files/ja/web/api/serviceworkerregistration/periodicsync/index.html new file mode 100644 index 0000000000..72e876c1d6 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/periodicsync/index.html @@ -0,0 +1,44 @@ +--- +title: ServiceWorkerRegistration.periodicSync +slug: Web/API/ServiceWorkerRegistration/periodicSync +tags: + - API + - Experimental + - PeriodicSyncManager + - Property + - Reference + - Service Workers + - ServiceWorkerRegistration + - periodicSync +translation_of: Web/API/ServiceWorkerRegistration/periodicSync +--- +
{{APIRef("Service Workers API")}}
+ +
+

注: この機能は、ある時点でサービスワーカーの説明でアイデアとして言及されましたが、まだどこにも実装されていません。

+
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの periodSync 読み取り専用プロパティは、定期的なバックグラウンド同期プロセスを管理する {{domxref("PeriodicSyncManager")}} インターフェイスへの参照を返します。

+ +

構文

+ +
var periodicSyncManager = serviceWorkerRegistration.periodicSync;
+
+ +

値

+ +

{{domxref("PeriodicSyncManager")}} オブジェクト。

+ +

例

+ +
// 未定
+ +

仕様

+ +

現在、どの仕様にも含まれていません。

+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.periodicSync")}}

diff --git a/files/ja/web/api/serviceworkerregistration/pushmanager/index.html b/files/ja/web/api/serviceworkerregistration/pushmanager/index.html new file mode 100644 index 0000000000..068acfa63d --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/pushmanager/index.html @@ -0,0 +1,80 @@ +--- +title: ServiceWorkerRegistration.pushManager +slug: Web/API/ServiceWorkerRegistration/pushManager +tags: + - API + - Property + - Push + - PushManager + - Reference + - Service Workers + - ServiceWorkerRegistration +translation_of: Web/API/ServiceWorkerRegistration/pushManager +--- +
{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの pushManager プロパティは、プッシュ購読を管理するための {{domxref("PushManager")}} インターフェイスへの参照を返します。 これには、購読申し込み、アクティブな購読の取得、プッシュ許可状況へのアクセスのサポートが含まれます。

+ +

構文

+ +
var pushManager = serviceWorkerRegistration.pushManager;
+
+ +

値

+ +

{{domxref("PushManager")}} オブジェクト。

+ +

例

+ +
this.onpush = function(event) {
+  console.log(event.data);
+  // ここから、IndexedDB にデータを書き込んだり、いずれかのウィンドウに
+  // それを送信したり、通知を表示したりできます。
+}
+
+navigator.serviceWorker.register('serviceworker.js').then(
+  function(serviceWorkerRegistration) {
+    serviceWorkerRegistration.pushManager.subscribe().then(
+      function(pushSubscription) {
+        console.log(pushSubscription.subscriptionId);
+        console.log(pushSubscription.endpoint);
+        // アプリケーションサーバが必要としているプッシュ購読の
+        // 詳細はここから使用できます。たとえば、XMLHttpRequest を使用して
+        // これを送信できます。
+      }, function(error) {
+        // 開発中は、コンソールにエラーを表示するのに役立ちます。
+        // 本番環境では、アプリケーションサーバにエラー情報を送信
+        // するためにも 役立ちます。
+        console.log(error);
+      }
+    );
+  });
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Push API', '#pushmanager-interface', 'PushManager')}}{{Spec2('Push API')}}初期定義。
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.pushManager")}}

+ +

関連項目

+ + diff --git a/files/ja/web/api/serviceworkerregistration/scope/index.html b/files/ja/web/api/serviceworkerregistration/scope/index.html new file mode 100644 index 0000000000..bd6e7b7b4f --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/scope/index.html @@ -0,0 +1,56 @@ +--- +title: ServiceWorkerRegistration.scope +slug: Web/API/ServiceWorkerRegistration/scope +tags: + - API + - Property + - Reference + - Service Workers + - ServiceWorkerRegistration + - scope +translation_of: Web/API/ServiceWorkerRegistration/scope +--- +
{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの scope 読み取り専用プロパティは、サービスワーカー登録の一意の識別子を返します。 サービスワーカーは、{{domxref("ServiceWorker")}} を登録する文書と同じオリジンにある必要があります。

+ +
+

注: この機能は Web Worker で使用できます。

+
+ +

構文

+ +
var swScope = serviceWorkerRegistration.scope;
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Service Workers', '#dom-serviceworkerregistration-scope', 'ServiceWorkerRegistration.scope')}}{{Spec2('Service Workers')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.scope")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/serviceworkerregistration/shownotification/index.html b/files/ja/web/api/serviceworkerregistration/shownotification/index.html new file mode 100644 index 0000000000..5f18ce75c1 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/shownotification/index.html @@ -0,0 +1,106 @@ +--- +title: ServiceWorkerRegistration.showNotification() +slug: Web/API/ServiceWorkerRegistration/showNotification +tags: + - API + - Method + - Reference + - Service Workers + - ServiceWorker + - ServiceWorkerRegistration + - showNotification +translation_of: Web/API/ServiceWorkerRegistration/showNotification +--- +

{{APIRef("Service Workers API")}}

+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの showNotification() メソッドは、アクティブなサービスワーカー上で通知を作成します。

+ +
+

注: この機能は Web Worker で使用できます。

+
+ +

構文

+ +
​serviceWorkerRegistration.showNotification(title, [options]);
+ +

パラメーター

+ +
+
title
+
通知内に表示する必要があるタイトル
+
options {{optional_inline}}
+
通知の設定を可能にするオブジェクト。 次のプロパティを持つことができます。 +
    +
  • actions: 通知に表示するアクションの配列。 配列のメンバーはオブジェクトリテラルである必要があります。 次の値が含まれる場合があります。 +
      +
    • action: 通知に表示されるユーザーアクションを識別する {{domxref("DOMString")}}。
      • +
    • title: ユーザーに表示されるアクションテキストを含む {{domxref("DOMString")}}。
      • +
    • icon: アクションで表示するアイコンの URL を含む {{domxref("USVString")}}。
      • +
    + 適切な応答は、{{event("notificationclick")}} イベント内の event.action を使用して作成されます。
    • +
  • badge: Android 通知バーなど、通知自体を表示するのに十分なスペースがない場合に通知を表す画像の URL を含む{{domxref("USVString")}}。 Android デバイスでは、バッジは最大 4x 解像度、約96 x 96 ピクセルのデバイスに対応する必要があり、画像は自動的にマスクされます。
    • +
  • body: 通知内に表示する追加のコンテンツを表す文字列。
    • +
  • data: 通知に関連付ける任意のデータ。 これは任意のデータ型にすることができます。
    • +
  • dir : 通知の方向。 auto、ltr、rtl のいずれかです。
    • +
  • icon: 通知でアイコンとして使用される画像の URL を含む {{domxref("USVString")}}。
    • +
  • image: 通知に表示される画像の URL を含む {{domxref("USVString")}}。
    • +
  • lang: 通知内で使用される言語を指定します。 この文字列は、有効な BCP 47 言語タグである必要があります。
    • +
  • renotify: tag 値を再利用するときにバイブレーションと可聴アラートを抑制するかどうかを示すブール値。 オプションの renotify が true で、オプションの tag が空の文字列の場合、TypeError がスローされます。 デフォルトは false です。
    • +
  • requireInteraction: 画面が十分に大きいデバイスでは、ユーザーがクリックするか閉じるまで通知をアクティブにしておく必要があることを示します。 この値がないか false の場合、デスクトップバージョンの Chrome は約20秒後に通知を自動的に最小化します。 デフォルト値は false です。
    • +
  • silent: 設定されている場合、音やバイブレーションは発生しないことを示します。 オプションの silent が true で、オプションの vibrate が存在する場合、TypeError 例外がスローされます。 デフォルト値は false です。
    • +
  • tag: 必要に応じてスクリプトを使用して通知を検索、置換、または削除できるようにする所与の通知の ID。
    • +
  • timestamp: 通知が作成された時刻を表す {{domxref("DOMTimeStamp")}}。 通知が実際に行われた時刻を示すために使用できます。 例えば、これは過去に、デバイスがオフラインだったためにすぐに配信できなかったメッセージに通知が使用された場合や、これから始まる会議に向けて通知が使用された場合などです。
    • +
  • vibrate: 通知の表示で実行するバイブレーションパターン。 バイブレーションパターンは、メンバーが1つしかない配列にすることができます。 値はミリ秒単位の時間で、偶数のインデックス（0、2、4 など）は振動する時間を示し、奇数のインデックスは一時停止する時間を示します。例えば、[300、100、400] は、300ミリ秒振動し、100ミリ秒休止してから、400ミリ秒振動します。
    • +
+
+
+ +

戻り値

+ +

undefined に解決する {{jsxref('Promise')}}。

+ +

例

+ +
navigator.serviceWorker.register('sw.js');
+
+function showNotification() {
+  Notification.requestPermission(function(result) {
+    if (result === 'granted') {
+      navigator.serviceWorker.ready.then(function(registration) {
+        registration.showNotification('バイブレーションの例', {
+          body: 'ブンブン! ブンブン!',
+          icon: '../images/touch/chrome-touch-icon-192x192.png',
+          vibrate: [200, 100, 200, 100, 200, 100, 200],
+          tag: 'vibration-sample'
+        });
+      });
+    }
+  });
+}
+ +

上記の関数を適切なタイミングで呼び出すには、{{domxref("ServiceWorkerGlobalScope.onnotificationclick")}} イベントハンドラーを使用できます。

+ +

{{domxref("ServiceWorkerRegistration.getNotifications()")}} を使用して、現在のサービスワーカーから発生した {{domxref("Notification")}} の詳細を取得することもできます。

+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Web Notifications','#dom-serviceworkerregistration-shownotification','showNotification()')}}{{Spec2('Web Notifications')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.showNotification")}}

diff --git a/files/ja/web/api/serviceworkerregistration/sync/index.html b/files/ja/web/api/serviceworkerregistration/sync/index.html new file mode 100644 index 0000000000..331625dbac --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/sync/index.html @@ -0,0 +1,48 @@ +--- +title: ServiceWorkerRegistration.sync +slug: Web/API/ServiceWorkerRegistration/sync +tags: + - API + - Experimental + - Property + - Reference + - Service Workers + - ServiceWorkerRegistration + - Sync +translation_of: Web/API/ServiceWorkerRegistration/sync +--- +
{{Non-standard_header}}{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの sync プロパティは、バックグラウンド同期プロセスを管理する {{domxref("SyncManager")}} インターフェイスへの参照を返します。

+ +

構文

+ +
var syncManager = serviceWorkerRegistration.sync;
+
+ +

値

+ +

{{domxref("SyncManager")}} オブジェクト。

+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Background Sync')}}{{Spec2('Background Sync')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.sync")}}

diff --git a/files/ja/web/api/serviceworkerregistration/unregister/index.html b/files/ja/web/api/serviceworkerregistration/unregister/index.html new file mode 100644 index 0000000000..ea95d1376e --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/unregister/index.html @@ -0,0 +1,82 @@ +--- +title: ServiceWorkerRegistration.unregister() +slug: Web/API/ServiceWorkerRegistration/unregister +tags: + - API + - Method + - Reference + - Service Workers + - ServiceWorkerRegistration + - unregister +translation_of: Web/API/ServiceWorkerRegistration/unregister +--- +
{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの unregister() メソッドは、サービスワーカー登録を登録解除し、{{jsxref("Promise")}} を返します。 登録が見つからなかった場合、Promise は false に解決されます。 それ以外の場合は、登録解除したかどうかに関係なく、true に解決されます（誰かが同じスコープで {{domxref("ServiceWorkerContainer.register()")}} をちょうど呼び出した場合は登録解除されない場合があります）。 サービスワーカーは、登録解除される前に進行中の操作を完了します。

+ +
+

注: この機能は Web Worker で使用できます。

+
+ +

構文

+ +
serviceWorkerRegistration.unregister().then(function(boolean) {
+});
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

{{jsxref("Promise")}} は、サービスワーカーが登録解除されているかどうかを示すブール値で解決します。

+ +

例

+ +

次の簡単な例では、サービスワーカーの例を登録していますが、すぐに再び登録を解除しています。

+ +
if ('serviceWorker' in navigator) {
+  navigator.serviceWorker.register('/sw-test/sw.js', {scope: 'sw-test'}).then(function(registration) {
+    // 登録しました
+    console.log('登録に成功しました。');
+    registration.unregister().then(function(boolean) {
+      // boolean = true ならば、登録解除は成功
+    });
+  }).catch(function(error) {
+    // 登録に失敗しました
+    console.log('登録に失敗しました:' + error);
+  });
+};
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Service Workers', 'navigator-service-worker-unregister', 'ServiceWorkerRegistration.unregister()')}}{{Spec2('Service Workers')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.unregister")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/serviceworkerregistration/update/index.html b/files/ja/web/api/serviceworkerregistration/update/index.html new file mode 100644 index 0000000000..b1542c16b9 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/update/index.html @@ -0,0 +1,81 @@ +--- +title: ServiceWorkerRegistration.update() +slug: Web/API/ServiceWorkerRegistration/update +tags: + - API + - Method + - Reference + - Service Worker + - ServiceWorkerRegistration + - Update +translation_of: Web/API/ServiceWorkerRegistration/update +--- +
{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの update() メソッドは、サービスワーカーの更新を試みます。 ワーカーのスクリプト URL をフェッチし、新しいワーカーが現在のワーカーとバイト単位で同一でない場合は、新しいワーカーをインストールします。 前回のフェッチが24時間以上前に行われた場合、ワーカーのフェッチはブラウザーキャッシュをバイパスします。

+ +
+

注: この機能は Web Worker で使用できます。

+
+ +

構文

+ +
serviceWorkerRegistration.update();
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

{{domxref("ServiceWorkerRegistration")}} オブジェクトで解決する {{jsxref("Promise")}}。

+ +

例

+ +

次の簡単な例では、サービスワーカーの例を登録し、次にイベントハンドラーをボタンに追加して、必要に応じてサービスワーカーを明示的に更新できるようにします。

+ +
if ('serviceWorker' in navigator) {
+  navigator.serviceWorker.register('/sw-test/sw.js', {scope: 'sw-test'}).then(function(registration) {
+    // 登録しました
+    console.log('登録に成功しました。');
+    button.onclick = function() {
+      registration.update();
+    }
+  }).catch(function(error) {
+    // 登録に失敗しました
+    console.log('登録に失敗しました:' + error);
+  });
+};
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Service Workers', '#service-worker-registration-update', 'ServiceWorkerRegistration.update()')}}{{Spec2('Service Workers')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.update")}}

+ +

関連情報

+ + diff --git a/files/ja/web/api/serviceworkerregistration/waiting/index.html b/files/ja/web/api/serviceworkerregistration/waiting/index.html new file mode 100644 index 0000000000..d00bfa83d5 --- /dev/null +++ b/files/ja/web/api/serviceworkerregistration/waiting/index.html @@ -0,0 +1,63 @@ +--- +title: ServiceWorkerRegistration.waiting +slug: Web/API/ServiceWorkerRegistration/waiting +tags: + - API + - Property + - Reference + - Service Workers + - ServiceWorkerRegistration + - waiting +translation_of: Web/API/ServiceWorkerRegistration/waiting +--- +
{{APIRef("Service Workers API")}}
+ +

{{domxref("ServiceWorkerRegistration")}} インターフェイスの waiting プロパティは、{{domxref("ServiceWorker.state")}} がインストール済み（installed）のサービスワーカーを返します。 このプロパティは、最初は null に設定されています。

+ +
+

注: この機能は Web Worker で使用できます。

+
+ +

構文

+ +
var serviceWorker = serviceWorkerRegistration.waiting;
+
+ +

値

+ +

{{domxref("ServiceWorker")}} オブジェクト（現在インストール済み（installed）の状態の場合）。

+ +

仕様

+ +
+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('Service Workers', '#navigator-service-worker-waiting', 'ServiceWorkerRegistration.waiting')}}{{Spec2('Service Workers')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ServiceWorkerRegistration.waiting")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf