WorkerNavigator: setAppBadge() メソッド

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

WorkerNavigator インターフェイスの setAppBadge() メソッドは、このアプリケーションに関連付けられたアイコンにバッジを設定します。このメソッドに値が渡された場合は、この値がバッジの値として設定されます。渡されなかった場合は、バッジは点もしくはプラットフォームで定義されたその他のインジケーターとして表示されます。

構文

js
setAppBadge()
setAppBadge(contents)

引数

contents 省略可

バッジの値として用いる number です。contents が 0 の場合は、バッジはクリアを表す nothing に設定されます。

返値

undefined で解決する Promise です。

例外

InvalidStateError DOMException

文書が完全にアクティブでないとき投げられます。

SecurityError DOMException

呼び出しが同一オリジンポリシーによりブロックされたとき投げられます。

NotAllowedError DOMException

PermissionStatus.state が granted でないとき投げられます。

例

以下の例では、未読カウントを setAppBadge() に渡します。すると、バッジに 30 が表示されるはずです。

js
const unread = 30;
navigator.setAppBadge(unread);

仕様書

No specification found

No specification data found for api.WorkerNavigator.setAppBadge.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

ブラウザーの互換性

BCD tables only load in the browser

関連情報