WorkerNavigator: setAppBadge() メソッド
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
WorkerNavigator インターフェイスの setAppBadge() メソッドは、このアプリケーションに関連付けられたアイコンにバッジを設定します。このメソッドに値が渡された場合は、この値がバッジの値として設定されます。渡されなかった場合は、バッジは点もしくはプラットフォームで定義されたその他のインジケーターとして表示されます。
構文
js
setAppBadge()
setAppBadge(contents)
引数
contents省略可-
バッジの値として用いる
Numberです。contentsが0の場合は、バッジはクリアを表すnothingに設定されます。
返値
例外
InvalidStateErrorDOMException-
文書が完全にアクティブでないとき投げられます。
SecurityErrorDOMException-
呼び出しが同一オリジンポリシーによりブロックされたとき投げられます。
NotAllowedErrorDOMException-
PermissionStatus.stateがgrantedでないとき投げられます。
例
以下の例では、未読カウントを setAppBadge() に渡します。すると、バッジに 30 が表示されるはずです。
js
const unread = 30;
navigator.setAppBadge(unread);