これは実験段階の機能です。
この機能は複数のブラウザで開発中の状態にあります。各ブラウザで用いるために、適切なベンダー接頭辞が必要な場合があります。互換性テーブルをチェックしてください。また、実験段階の機能の構文と挙動は、仕様変更に伴い各ブラウザの将来のバージョンで変更になる可能性があることに注意してください。
Push API の PushSubscription インターフェースは、サブスクリプションの URL エンドポイントを提供するとともに、プッシュサービスの登録を解除できます。
このインターフェースのインスタンスはシリアライズできます。
プロパティ
PushSubscription.endpoint読取専用- プッシュサービスに関連したエンドポイントを含む
USVString。
PushSubscription.subscriptionId読取専用- プッシュサービスに関連したサブスクリプション ID を含む
DOMString。
メソッド
PushSubscription.getKey()- サーバに送信されてプッシュメッセージの暗号化に使用される、クライアントのパブリックキーを含む
ArrayBufferを返す。 PushSubscription.toJSON()- 標準シリアライザー — サブスクリプションプロパティの JSON 記法を返す。
PushSubscription.unsubscribe()- プッシュサービスの登録を解除する非同期プロセスを開始する。現在のサブスクリプションが成功裏に登録解除できた場合、
Booleanで解決されるPromiseを返す。
例
navigator.serviceWorker.ready.then(function(reg) {
reg.pushManager.getSubscription().then(function(subscription) {
subscription.unsubscribe().then(function(successful) {
// 成功裏に登録解除。
}).catch(function(e) {
// 登録解除失敗。
})
})
});
仕様
| 仕様 | 状態 | コメント |
|---|---|---|
| Push API PushSubscription の定義 |
草案 | 初期定義。 |
ブラウザ実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| 基本サポート | 42.0 | 44.0 (44.0)[1] | 未サポート | ? | 未サポート |
| 機能 | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|---|
| 基本サポート | 未サポート | 未サポート | 48.0 (48)[2] | 未サポート | 未サポート | 未サポート | 未サポート | 42.0 |
- [1] Push（と Service Workers） は、Firefox 45 延長サポート版（ESR）では使用できません。
- [2] Firefox for Android 48 から、既定で Push を使用できます。