background

Тип Object
Обязательный Нет
Пример
"background": {
  "scripts": ["background.js"]
}

Используйте ключ background для включения одного или нескольких фоновых сценариев и, возможно, фоновой страницы в вашем расширении.

Фоновые сценарии - это место для размещения кода, который должен поддерживать долгосрочное состояние или выполнять долгосрочные операции, независимо от времени жизни каких-либо конкретных веб-страниц или окон браузера.

Фоновые сценарии загружаются сразу после загрузки и остаются загруженными до тех пор, пока расширение не будет отключено или удалено. Вы можете использовать любой API-интерфейс WebExtension в сценарии, если вы запросили необходимые права.

Дополнительную информацию см. В разделе «Справочные страницы» в Anatomy of a WebExtension .

Фоновый ключ - это объект, который может иметь одно из следующих двух свойств: оба необязательные:

"scripts"

Массив строк, каждый из которых представляет собой путь к источнику JavaScript. Путь относится к самому файлу manifest.json. Это фоновые скрипты, которые будут включены в расширение.

Скрипты используют одно и то же окно глобального.

Сценарии загружаются в порядке их появления в массиве.

Обратите внимание, что есть ошибка, влияющая на версии Firefox меньше 50: когда отладчик Firefox открыт, скрипты не всегда загружаются в порядке, указанном в массиве. Чтобы обойти эту ошибку, вы можете использовать свойство "page" и включить фоновые сценарии со страницы, используя теги <script>. Эта ошибка исправлена в Firefox 50, и с этого момента скрипты всегда загружаются в порядке, указанном в массиве.

"page"

Если вы укажете "scripts", тогда будет создана пустая страница для запуска ваших скриптов.

Если вам нужен определенный контент на странице, вы можете определить свою собственную страницу, используя опцию «страница».

Если вы используете это свойство, вы больше не можете указывать фоновые сценарии, используя "scripts", но вы можете включать свои собственные скрипты со страницы, как на обычной веб-странице.

Например

  "background": {
    "scripts": ["jquery.js", "my-background.js"]
  }

Загрузка двух фоновых сценариев.

  "background": {
    "page": "my-background.html"
  }

Загрузка пользовательской страницы.

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxOperaFirefox для Android
backgroundChrome Полная поддержка ДаEdge Полная поддержка 14Firefox Полная поддержка 48Opera Полная поддержка ДаFirefox Android Полная поддержка 48
pageChrome Полная поддержка ДаEdge Полная поддержка 14Firefox Полная поддержка 48Opera Полная поддержка ДаFirefox Android Полная поддержка 48
persistentChrome Полная поддержка ДаEdge Полная поддержка 14
Замечания
Полная поддержка 14
Замечания
Замечания The 'persistent' property is mandatory.
Firefox Частичная поддержка 48
Замечания
Частичная поддержка 48
Замечания
Замечания Only persistent pages are supported.
Замечания Before version 66, Firefox would log a warning even if the value was set to true.
Opera Полная поддержка ДаFirefox Android Частичная поддержка 48
Замечания
Частичная поддержка 48
Замечания
Замечания Only persistent pages are supported.
Замечания Before version 66, Firefox would log a warning even if the value was set to true.
scriptsChrome Полная поддержка ДаEdge Полная поддержка 14Firefox Полная поддержка 48
Замечания
Полная поддержка 48
Замечания
Замечания Before Firefox 50, when the debugger is open, scripts are not always loaded in the order given in the array.
Opera Полная поддержка ДаFirefox Android Полная поддержка 48
Замечания
Полная поддержка 48
Замечания
Замечания Before Firefox 50, when the debugger is open, scripts are not always loaded in the order given in the array.

Легенда

Полная поддержка  
Полная поддержка
Частичная поддержка  
Частичная поддержка
Смотрите замечания реализации.
Смотрите замечания реализации.