Notification: Notification() コンストラクター

構文

引数

通知ウィンドウの最上部に表示される、通知のためのタイトルを定義します。

通知に適用するカスタム設定を含むオプションオブジェクトです。使用できるオプションは以下のとおりです。

通知を表示する方向です。既定値は auto で、ブラウザーの言語設定の振る舞いが適用されますが、 ltr と rtl の値で振る舞いを上書きできます (ただし、ほとんどのブラウザーがこれらの設定を無視しているようですが)。

RFC 5646: 言語を識別するタグ（BCP 47 とも）を表す文字列を使って指定される通知の言語です。 簡単なリファレンスとして ISO 2 letter language codes ページを参照してください。 既定値は空文字列です。

文字列で、通知自体を表示する充分な空間がない場合に通知の表現に使用される画像の URL を指定します。

文字列で、タイトルの下側に表示される通知の本文を表します。 既定値は空文字列です。

通知のための識別タグを表す 文字列です。

通知の一部として表示されるアイコンのURLを含む文字列です。

文字列で、通知に表示される画像の URL を指定します。

通知に関連付ける任意のデータです。これはどのデータ型でも可能です。 既定値は null です。

通知が発生したときに端末のバイブレーションハードウェアに通知するバイブレーションパターンです。指定された場合、silent は true にできません。

数値で、通知が作成された時点または適用される時点（過去、現在、未来）を表します。

古い通知が新しい通知に置き換えられた後、ユーザーに通知するかどうかを指定する論理値です。既定値は false で、通知しないことを意味します。true の場合、tag も設定する必要があります。

通知が自動的に閉じるのではなく、ユーザーがクリックするか解除するまでアクティブな状態を維持すべきであることを示します。 既定値は false です。

通知で表示するアクションの配列です。配列内のそれぞれの要素は、以下のメンバーを持つオブジェクトです。

通知上に表示されるユーザーアクションを特定する文字列。

ユーザーに表示するアクションテキストを含む文字列。

アクションとともに表示されるアイコンの URL を含む文字列。

適切なレスポンスは event.action を使用して notificationclick イベント内で構築されます。

通知をサイレントにするかどうかを指定する論理値です。端末の設定にかかわらず、音やバイブレーションを発しないようにします。 既定値は null です。true の場合、 vibrate が存在してはいけません。

返値

Notification オブジェクトのインスタンスです。

例外

以下の場合に例外が発生します。

• コンストラクターが ServiceWorkerGlobalScope の中で呼び出された場合。
• actions オプションが設定されており、空であった場合。
• silent オプションが true で、vibrate オプションが指定されていた場合。
• renotify オプションが true だが、tag オプションが空の場合。

何らかの理由で data オプションのシリアライズに失敗した場合に発生します。

例

この例は、その権限がすでに付与されている場合にのみ通知を表示させるという最も基本的なものです。より完全な例については、Notification ページをご覧ください。

仕様書

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Chrome の注意事項

Chrome 49 以降では、 incognito モードでは通知が動作しません。

Android 版 Chrome は Notification コンストラクターを呼び出すと TypeError を発生させます。サービスワーカーからの通知の作成にのみ対応しています。詳しくは Chromium issue tracker をご覧ください。

関連情報

• 通知 API の使用