Spec-Zone.ru › Web Extensions

chrome_settings_overrides

Тип Object
Обязательно Нет
Версия манифеста 2 или выше
Пример
"chrome_settings_overrides" : {
  "homepage": "https://developer.mozilla.org/"
 },

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

Синтаксис

Ключ chrome_settings_overrides — это объект, который может иметь следующие свойства:

Имя Тип Описание
homepage String

Определяет страницу, которая будет использоваться в качестве домашней страницы браузера.

Замена предоставляется в виде URL. URL может:

  • указывать на файл, входящий в состав расширения, в этом случае он задаётся как URL, относительный к файлу manifest.json
  • быть удалённым URL, например, «https://developer.mozilla.org/».

Если два или более расширений задают это значение, то предпочтение отдаётся настройке, установленной последним.

Для переопределения новых вкладок используйте "chrome_url_overrides" вместо этого.

Это свойство локальное.

search_provider Object

Определяет поставщика поисковой системы для добавления в браузер.

Поставщик поисковой системы имеет имя и основной поисковый URL. Могут быть предоставлены альтернативные URL, включая URL для более специализированных поисков, таких как поиск изображений. В предоставленном URL используйте «{searchTerms}», чтобы интерполировать поисковый запрос в URL, например: https://www.discogs.com/search/?q={searchTerms}. Вы также можете предоставить параметры POST, которые будут отправлены вместе с запросом.

Поставщик поисковой системы будет представлен пользователю вместе с встроенными поставщиками. Если вы включите свойство is_default и установите его в значение true, новый поставщик поисковой системы станет вариантом по умолчанию. Предоставив свойство keyword, вы позволяете пользователю выбрать ваш поставщик поисковой системы, введя ключевое слово в строку поиска/адреса перед поисковым запросом.

Это объект со свойствами, перечисленными ниже. Все строковые свойства являются локальными.

name
Строка: имя поисковой системы, отображаемое пользователю.
search_url
Строка: URL, используемый поисковой системой. Это должен быть URL HTTPS.
is_default Optional
Булево: Истина, если поисковая система должна быть вариантом по умолчанию. В Firefox это опционально, и пользователь будет спрошен только при первом установлении расширения. Его не будут спрашивать повторно, если поисковая система будет добавлена позже.
alternate_urls Optional
Массив строк: массив альтернативных URL, которые можно использовать вместо search_url.
encoding Optional
Строка: Кодировка поискового запроса, указанная как имя стандартной кодировки символов, например, «UTF-8».
favicon_url Optional
Строка: URL, указывающий на значок поисковой системы. В манифесте V2 это должен быть абсолютный URL HTTP или HTTPS. В манифесте V3 это должно ссылаться на значок, предоставленный в расширении, как путь, относительный к корню расширения.
image_url Optional
Строка: URL, используемый для поиска изображений.
image_url_post_params Optional
Строка: параметры POST для отправки на image_url.
instant_url Optional
Строка: URL, используемый для мгновенного поиска.
instant_url_post_params Optional
Строка: параметры POST для отправки на instant_url.
keyword Optional
Строка: ключевое слово адресной строки для поисковой системы.
prepopulated_id Optional
Идентификатор встроенной поисковой системы для использования.
search_url_post_params Optional
Строка: параметры POST для отправки на search_url.
suggest_url Optional
Строка: URL, используемый для предложений по поиску. Это должен быть URL HTTPS.
suggest_url_post_params Optional
Строка: параметры POST для отправки на suggest_url.

Пример

В этом примере показано, как установить поставщика поисковой системы.

"chrome_settings_overrides": {
  "search_provider": {
    "name": "Discogs",
    "search_url": "https://www.discogs.com/search/?q={searchTerms}",
    "keyword": "disc",
    "favicon_url": "https://www.discogs.com/favicon.ico"
  }
}

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet
chrome_settings_overrides Да 79 55 ? Нет Нет ? ? Нет ? Нет ?
homepage Да 79 55 ? Нет Нет ? ? Нет ? Нет ?
search_provider Да 79 55 ? Нет Нет ? ? Нет ? Нет ?
startup_pages Да 79 Нет ? Нет Нет ? ? Нет ? Нет ?

© 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/chrome_settings_overrides

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API