We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Notification.Notification()

この翻訳は不完全です。英語から この記事を翻訳 してください。

Notification() コンストラクターは新しいNotification オブジェクトインスタンスを生成します。

註: この機能は Web Workers 内で利用可能です。

構文

var myNotification = new Notification(title, options);

パラメーター

title
通知のためのタイトルを定義します。発火したときにタイトルは通知ウィンドウのトップに表示されます。
options Optional
通知に適用するカスタム設定を含むオプションオブジェクトです。使用できるオプションは以下のとおりです。
  • dir: 通知を表示する方向です。既定値はautoで、ブラウザの言語設定の振る舞いが適用されます。しかし、ltrとrtlの値で振る舞いを上書きできます(ほとんどのブラウザがこれらの設定を無視するように見えますが)。
  • lang: BCP 47 language tagを表すDOMString を使って指定される通知の言語です。簡単なリファレンスとしてISO 2 letter language codesページを参照してください。
  • badge: A USVString containing the URL of the image used to represent the notification when there is not enough space to display the notification itself.
  • body: タイトルの下側に表示される通知の本文を表すDOMStringです。
  • tag:通知のための識別タグを表す DOMString です。
  • icon:通知の一部として表示されるアイコンのURLを含むUSVString です。
  • image: a USVString containing the URL of an image to be displayed in the notification.
  • data: 通知に関連付ける任意のデータです。これはいづれのデータ型でも可能です。
  • vibrate: 通知が発火したときにデバイスのバイブレーションハードウェアに通知するバイブレーションパターンです。
  • renotify: 古い通知が新しい通知に置き換えられた後、ユーザーに通知するかどうかを指定するBoolean値です。既定値はfalseで、通知しないことを意味します。
  • requireInteraction: Indicates that a notification should remain active until the user clicks or dismisses it, rather than closing automatically. The default value is false.

The following options are listed in the most up-to-date spec, but are not supported in any browsers yet. It is advisable to keep checking back regularly to see if the status of these has updated, and let us know if you find any out of date information.

  • sound: 通知が発火したときに再生されるオーディオファイルのURLを含むUSVStringです。
  • silent: 通知をサイレントにするかどうかを指定するBoolean 値です。たとえば、デバイスの設定にかかわらず、音やバイブレーションを発しないようにします。既定値はfalseで、サイレントではないことを意味します。
  • noscreen: 通知を発火するのにデバイスの画面を有効にするべきかしないべきかを指定するBoolean値です。既定値はfalseで、画面を有効にすることを意味します。
  • sticky: 通知が'sticky'かどうかを指定するBoolean 値です。たとえば、stickyはユーザーが簡単に消せないことを表します。既定値はfalseで、stickyではないことを意味します。

次のオプションは最新の仕様にリストされていますが、まだどのブラウザでもサポートされていません。ステータスが更新されたかどうか、定期的に確認することをお勧めします。もし、このドキュメントが古くなっていることに気づいたら、私たちに教えてください。

私たちの 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
Notification() の定義
現行の標準 Living standard

ブラウザ実装状況

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 5 webkit (see notes)
22
4.0 moz (see notes)
22 

Edge 38.14352

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 未サポート
vibrate 45.0 未サポート 未サポート 未サポート 未サポート
requireInteraction 47.0     32  
renotify 50.0        
badge 53.0     39.0  
image 55.0     ?  
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
未サポート ? 未サポート (有)
vibrate 未サポート 45.0 未サポート 未サポート 未サポート 32 未サポート 45.0
requireInteraction 未サポート 未サポート           未サポート
renotify 未サポート 未サポート           50.0
badge 未サポート 53.0       39.0   53.0
image 未サポート 未サポート       ?   55.0

Firefox OS notes

Chrome notes

Safari notes

関連項目

ドキュメントのタグと貢献者

このページの貢献者: Gits-migii, hinaloe, YuichiNukiyama
最終更新者: Gits-migii,