browser_specific_settings

Тип	`Object`
Обязательный	Обычно нет (но см. также Когда необходим идентификатор дополнения?). Обязательно, если идентификатор расширения определить невозможно, см. `browser_specific_settings.gecko.id`.
Пример	"browser_specific_settings": { "gecko": { "id": "addon@example.com", "strict_min_version": "42.0" } }

Описание

Ключ browser_specific_settings содержит ключи, специфичные для конкретного приложения-хоста.

Свойства Firefox (Gecko)

Firefox хранит свои специфичные для браузера настройки в подключаемом элементе gecko, который имеет следующие свойства:

id: Идентификатор расширения. Для расширений, отправленных на addons.mozilla.org (AMO), см. Расширения и идентификатор дополнения, чтобы определить, когда вам нужно указать идентификатор. Если это требуется AMO, это свойство должно содержать не более 80 символов. Для расширений, не отправленных на AMO, если расширение не подписано (и не загружено с помощью about:debugging), ID требуется; в противном случае ID необязателен.
strict_min_version: Минимальная версия Gecko для поддержки. Версии, содержащие «*», в этом поле недопустимы. По умолчанию «42a1».
strict_max_version: Максимальная версия Gecko для поддержки. Если версия Firefox, на которой устанавливается или выполняется расширение, выше этой версии, расширение будет отключено или не разрешено для установки. По умолчанию «*», что отключает проверку максимальной версии.
update_url: Ссылка на справочник по обновлению расширения. Обратите внимание, что ссылка должна начинаться с «https». Этот ключ предназначен для самостоятельного управления обновлениями расширений (т. е. не через AMO).

См. список допустимых версий Gecko.

Формат идентификатора расширения

Идентификатор расширения должен быть одним из следующих:

GUID
Строка, отформатированная как адрес электронной почты: extensionname@example.org

Последний формат легче генерировать и обрабатывать. Имейте в виду, что использование реального адреса электронной почты здесь может привлечь спам.

Например:

"id": "extensionname@example.org"

"id": "{daf44bf7-a45e-4450-979c-91cf07434c3d}"

Свойства Microsoft Edge

Предупреждение: Добавление свойств, специфичных для Edge, в манифест вызывало ошибку до Firefox 69, что может помешать установке расширения.

Microsoft Edge хранит свои специфичные для браузера настройки в подключаемом элементе edge, который имеет следующие свойства:

browser_action_next_to_addressbar

Булево свойство, которое управляет расположением действия браузера.

true эквивалентно установке browser_action.default_area на navbar.
false эквивалентно установке browser_action.default_area на menupanel.

Свойства Safari

Предупреждение: Добавление свойств, специфичных для Safari, в манифест вызывало ошибку до Firefox 69, что может помешать установке расширения.

Safari хранит свои специфичные для браузера настройки в подключаемом элементе safari, который имеет следующие свойства:

strict_min_version: Минимальная версия Safari для поддержки.
strict_max_version: Максимальная версия Safari для поддержки.

Примеры

Пример со всеми возможными ключами. Обратите внимание, что большинство расширений опустят strict_max_version и update_url.

"browser_specific_settings": {
  "gecko": {
    "id": "addon@example.com",
    "strict_min_version": "42.0",
    "strict_max_version": "50.*",
    "update_url": "https://example.com/updates.json"
  },
  "safari": {
    "strict_min_version": "14",
    "strict_max_version": "20"
  }
}

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

	Рабочий стол						Мобильный
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`browser_specific_settings`	Нет	15–79	42 До Firefox 48 это свойство было обязательным.	?	Нет	14 Поддерживает `strict_min_version` и `strict_max_version` в блоке `safari`.	?	?	42 До Firefox 48 это свойство было обязательным.	?	15 Поддерживает `strict_min_version` и `strict_max_version` в блоке `safari`.	?

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_specific_settings