blob: 2c2b17466ad721a9f444796926235a1a90ac6c83 (
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
|
---
title: Notification.close()
slug: Web/API/Notification/close
tags:
- API
- DOM
- Method
- Notification
- Notifications
- Notifications API
- Reference
- WebAPI
- close
- メソッド
- 通知
translation_of: Web/API/Notification/close
---
<p>{{APIRef("Web Notifications")}}{{AvailableInWorkers}}{{securecontext_header}}</p>
<p><code>close()</code> は {{domxref("Notification")}} インターフェイスのメソッドで、表示された通知を閉じたり削除したりするために使用されます。</p>
<div class="note">
<p><strong>注:</strong> この API は、一定時間経過後に通知を画面から消去するだけのために使用すべきではありません。通知が最初に表示された後にユーザーがそれとやりとりすることを防ぐため、このメソッドは通知トレイからも通知を削除するためです。この API の正しい使用方法は、ユーザーに関係がなくなった通知を除去することです (例えば、メッセージアプリなどで、ユーザーが既にウェブページ上の通知を読んだ場合や、音楽アプリですでに次の曲が始まっているため、曲の変更を行うための通知を閉じるなど)。</p>
</div>
<h2 id="Syntax" name="Syntax">構文</h2>
<pre class="syntaxbox notranslate">Notification.close();</pre>
<h3 id="Parameters" name="Parameters">引数</h3>
<p>なし。</p>
<h3 id="Returns" name="Returns">返値</h3>
<p>なし。</p>
<h2 id="Examples" name="Examples">例</h2>
<p>以下のスニペットは、呼び出されたときに <code>options</code> オブジェクトと、それから新しい通知を生成します。を生成し、関数の末尾で、 <code>close()</code> を {{domxref("EventTarget.addEventListener","addEventListener()")}} 関数の中で呼び出し、関連するコンテンツがウェブページで既読になったときに通知を除去します。</p>
<pre class="brush:js notranslate">function spawnNotification(theBody, theIcon, theTitle) {
var options = {
body: theBody,
icon: theIcon
};
var n = new Notification(theTitle,options);
document.addEventListener('visibilitychange', function() {
if (document.visibilityState === 'visible') {
// The tab has become visible so clear the now-stale Notification.
n.close();
}
});
}
</pre>
<h2 id="Specifications" name="Specifications">仕様書</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">仕様書</th>
<th scope="col">状態</th>
<th scope="col">備考</th>
</tr>
<tr>
<td>{{SpecName('Web Notifications')}}</td>
<td>{{Spec2('Web Notifications')}}</td>
<td>Living standard</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
<p>{{Compat("api.Notification.close")}}</p>
<h2 id="See_also" name="See_also">関連情報</h2>
<ul>
<li><a href="/ja/docs/Web/API/Notifications_API/Using_the_Notifications_API">通知 API の使用</a></li>
</ul>
|
