この記事は編集レビューを必要としています。ぜひご協力ください。
Notification()
コンストラクターは新らしいNotification
オブジェクトインスタンスを生成します。
註: This feature is available in Web Workers.
構文
var myNotification = new Notification(title, options);
パラメーター
sound
: 通知が発火したときに再生されるオーディオファイルのURLを含むUSVString
です。vibrate
: 通知が発火したときにデバイスのバイブレーションハードウェアに通知するバイブレーションパターンです。renotify
: 古い通知が新しい通知に置き換えられた後、ユーザーに通知するかどうかを指定するBoolean
値です。既定値はfalseで、通知しないことを意味します。silent
: 通知をサイレントにするかどうかを指定するBoolean
値です。たとえば、デバイスの設定にかかわらず、音やバイブレーションを発しないようにします。既定値はfalseで、サイレントではないことを意味します。noscreen
: 通知を発火するのにデバイスの画面を有効にするべきかしないべきかを指定するBoolean
値です。既定値はfalseで、画面を有効にすることを意味します。sticky
: 通知が'sticky'かどうかを指定するBoolean
値です。たとえば、stickyはユーザーが簡単に消せないことを表します。既定値はfalseで、stickyではないことを意味します。
- title
- 通知のためのタイトルを定義します。発火したときにタイトルは通知ウィンドウのトップに表示されます。
- options Optional
- 通知に適用するカスタム設定を含むオプションオブジェクトです。使用できるオプションは以下のとおりです。
dir
: 通知を表示する方向です。既定値はautoで、ブラウザの言語設定の振る舞いが適用されます。しかし、ltrとrtlの値で振る舞いを上書きできます(ほとんどのブラウザがこれらの設定を無視するように見えますが)。lang
: BCP 47 language tagを表すDOMString
を使って指定される通知の言語です。簡単なリファレンスとしてISO 2 letter language codesページを参照してください。body
: タイトルの下側に表示される通知の本文を表すDOMString
です。tag
:通知のための識別タグを表すDOMString
です。icon
:通知の一部として表示されるアイコンのURLを含むUSVString
です。data
: 通知に関連付ける任意のデータです。これはいづれのデータ型でも可能です。
次のオプションは最新の仕様にリストされていますが、まだどのブラウザでもサポートされていません。ステータスが更新されたかどうか、定期的に確認することをお勧めします。もし、このドキュメントが古くなっていることに気づいたら、私たちに教えてください。
例
私たちの Emogotchi demo (see source code)では、私たちが通知を発火したいときに、spawnNotification()
関数を実行しています。― これはbodyとicon、titleを指定する引数が渡され、必要なoptionsオブジェクトを生成してからNotification()コンストラクタを使って通知を発火します。
function spawnNotification(theBody,theIcon,theTitle) { var options = { body: theBody, icon: theIcon } var n = new Notification(theTitle,options); }
仕様
Specification | Status | Comment |
---|---|---|
Notifications API The definition of 'Notification()' in that specification. |
Living Standard | Living standard |
ブラウザ実装状況
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 5 webkit (see notes) 22 |
4.0 moz (see notes) 22 |
未サポート | 25 | 6 (see notes) |
Available in workers | ? | 41.0 (41.0) | ? | ? | ? |
icon option | 5 webkit (see notes) 22 |
4.0 moz (see notes) 22 |
未サポート | 25 | 未サポート |
noscreen, renotify, silent, sound, and sticky options | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | ? |
(有) |
4.0 moz (see notes) 22 |
1.0.1 moz (see notes) 1.2 |
未サポート | ? | 未サポート |
(有) |
Available in workers | ? | ? | 41.0 (41.0) | ? | ? | ? | ? | ? |
icon option | ? | (有) | 4.0 moz (see notes) 22 |
1.0.1 moz (see notes) 1.2 |
未サポート | ? | 未サポート | (有) |
noscreen, renotify, silent, sound, and sticky options | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート | 未サポート |