Navigator: метод setAppBadge()

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

Метод setAppBadge() интерфейса Navigator устанавливает значок на значке, связанном с этим приложением. Если методу передано значение, это значение будет установлено как значение значка. В противном случае значок будет отображаться как точка или другой индикатор, определённый платформой.

Синтаксис

setAppBadge()
setAppBadge(contents)

Параметры

contents Необязательно: Числовое значение number, которое будет использовано как значение значка. Если contents равно 0, то значок будет установлен на nothing, что указывает на сброс значка.

Возвращаемое значение

Объект Promise, который разрешается со значением undefined.

Исключения

InvalidStateError DOMException: Выбрасывается, если документ не полностью активирован.
SecurityError DOMException: Выбрасывается, если вызов заблокирован политикой одного происхождения.
NotAllowedError DOMException: Выбрасывается, если PermissionStatus.state не имеет значение granted.

Примеры

В примере ниже количество непрочитанных сообщений передается в setAppBadge(). Значок должен отображать 30.

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

Спецификации

Спецификация
API значков # setappbadge-method

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`setAppBadge`	81 Только Windows и macOS. Linux не предоставляет универсального API для значков на уровне операционной системы.	81 Только Windows и macOS. Linux не предоставляет универсального API для значков на уровне операционной системы.	Нет	Нет	17 ["Поддержка значков для установленных веб-приложений в macOS Sonoma и новее.", "Передача `0` в качестве аргумента сбросит значок, а не отобразит точку без номера."]	Нет	Нет	Нет	16.4 ["Поддержка значков для веб-приложений, сохраненных на главном экране.", "Передача `0` в качестве аргумента сбросит значок, а не отобразит точку без номера."]	Нет	Нет

См. также

Значки для значков приложений

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Navigator/setAppBadge