blob: d2fabe1b8677ea0fb8b938985b7fbd0e3a2b5cd4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
---
title: PushManager.getSubscription()
slug: Web/API/PushManager/getSubscription
tags:
- API
- Experimental
- Method
- PushManager
- Reference
- Service Workers
translation_of: Web/API/PushManager/getSubscription
---
<p>{{SeeCompatTable}}{{ApiRef("Push API")}}</p>
<p>{{domxref("PushManager")}} インターフェースの <strong><code>PushManager.getSubscription()</code></strong> メソッドは、既存のプッシュサブスクリプションを取得します。</p>
<p>これは既存のプッシュサブスクリプションの詳細を含む {{domxref("PushSubscription")}} を解決する {{jsxref("Promise")}} を返します。既存のプッシュサブスクリプションが存在しない場合 <code>null</code> 値で解決されます。</p>
<h2 id="構文">構文</h2>
<pre class="brush: js" style="font-size: 14px;">PushManager.getSubscription().then(function(pushSubscription) { ... } );</pre>
<h3 id="パラメーター">パラメーター</h3>
<p>なし。</p>
<h3 id="戻り値">戻り値</h3>
<p>{{domxref("PushSubscription")}} オブジェクトで解決される {{jsxref("Promise")}}。</p>
<h2 id="例">例</h2>
<p>このコードスニペットは、<a href="https://github.com/GoogleChrome/samples/blob/gh-pages/push-messaging-and-notifications">push messaging and notification sample </a>から取ってきました（使用できるライブデモはありません）。</p>
<pre class="brush: js" style="font-size: 14px;">// サブスクリプションをチェックするために、service worker の登録が必要である。
navigator.serviceWorker.ready.then(function(serviceWorkerRegistration) {
// 既にプッシュメッセージサブスクリプションがあるか？
serviceWorkerRegistration.pushManager.getSubscription()
.then(function(subscription) {
// プッシュメッセージからサブスクライブ ／ アンサブスクライブ
// する任意の UI を有効にする
var pushButton = document.querySelector('.js-push-button');
pushButton.disabled = false;
if (!subscription) {
// プッシュを購読していない場合、ユーザーがプッシュできるように
// UI を設定する。
return;
}
// 最新の subscriptionId でサーバ同期を維持する。
sendSubscriptionToServer(subscription);
showCurlCommand(subscription);
// プッシュメッセージの購読を表示するために
// UI を設定する。
pushButton.textContent = 'Disable Push Messages';
isPushEnabled = true;
})
.catch(function(err) {
window.Demo.debug.log('Error during getSubscription()', err);
});
});
}</pre>
<h2 id="仕様">仕様</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">仕様</th>
<th scope="col">状態</th>
<th scope="col">コメント</th>
</tr>
<tr>
<td>{{SpecName('Push API', '#widl-PushManager-getSubscription-Promise-PushSubscription', 'getSubscription()')}}</td>
<td>{{Spec2('Push API')}}</td>
<td>初期定義。</td>
</tr>
</tbody>
</table>
<h2 id="ブラウザ実装状況">ブラウザ実装状況</h2>
<div>{{CompatibilityTable}}</div>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>機能</th>
<th>Chrome</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari (WebKit)</th>
</tr>
<tr>
<td>基本サポート</td>
<td>{{CompatChrome(42.0)}}</td>
<td>{{CompatGeckoDesktop(44.0)}}<sup>[1]</sup></td>
<td>{{CompatNo}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatNo}}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>機能</th>
<th>Android</th>
<th>Android Webview</th>
<th>Firefox Mobile (Gecko)</th>
<th>Firefox OS</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
<th>Chrome for Android</th>
</tr>
<tr>
<td>基本サポート</td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatGeckoMobile(48)}}<sup>[2]</sup></td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatChrome(42.0)}}</td>
</tr>
</tbody>
</table>
</div>
<ul>
<li>[1] Push（と <a href="/en-US/docs/Web/API/Service_Worker_API">Service Workers</a>）は、 have been disabled in the <a href="https://www.mozilla.org/ja/firefox/organizations/">Firefox 45 延長サポート版</a> （ESR）では使用できません。</li>
<li>[2] Firefox for Android 48 から、既定で Push を使用できます。</li>
</ul>
<h2 id="関連項目">関連項目</h2>
<ul>
<li><a href="/ja/docs/Web/API/Push_API/Using_the_Push_API">Using the Push API</a></li>
</ul>
|
