chrome_url_overrides
| Тип | Object |
|---|---|
| Обязательно | Нет |
| Версия манифеста | 2 или выше |
| Пример | "chrome_url_overrides" : { "newtab": "my-new-tab.html" } |
Используйте ключ chrome_url_overrides для предоставления пользовательской замены документов, загружаемых на различные специальные страницы, обычно предоставляемые самим браузером.
Синтаксис
Ключ chrome_url_overrides — это объект, который может иметь следующие свойства:
| Имя | Тип | Описание |
|---|---|---|
bookmarks | String | Предоставляет замену страницы, отображающей закладки. |
history | String | Предоставляет замену страницы, отображающей историю посещений. |
newtab | String | Предоставляет замену документа, отображаемого на странице «новая вкладка». Это страница, которая отображается, когда пользователь открыл новую вкладку, но не загрузил в неё никакой документ: например, с помощью сочетания клавиш Ctrl/Command+T. Замена предоставляется в виде URL-адреса HTML-файла. Файл должен быть включён в расширение; вы не можете указать удалённый URL-адрес. Вы можете указать его относительно корневой папки расширения, например: "path/to/newtab.html". Документ может загружать CSS и JavaScript, как и обычная веб-страница. JavaScript, выполняемый на странице, получает доступ к тем же привилегированным API «browser.*», что и фоновый скрипт расширения. Рекомендуется включать <title> для страницы, иначе заголовок вкладки будет URL-адресом "moz-extension://...". Частое применение — создание пользовательской страницы новой вкладки: для этого предоставите пользовательскую страницу новой вкладки, которая перенаправляется на страницу, определённую пользователем. Если два или более расширений определяют пользовательские страницы новой вкладки, то последнему установленным или включённому расширению будет предоставлено его значение. Для переопределения домашней страницы браузера используйте "chrome_settings_overrides" вместо этого. |
Все свойства локально локализуемы.
Пример
"chrome_url_overrides" : { "newtab": "my-new-tab.html" }
Совместимость с браузерами
| Рабочий стол | Мобильный | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
chrome_url_overrides |
Да | 79 | 54 | ? | Нет | 1514.1 | ? | ? | Нет | ? | 15 | ? |
bookmarks |
Да | 79 | Нет | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
history |
Да | 79 | Нет | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
newtab |
ДаЕсли два или более расширений определяют пользовательскую страницу новой вкладки, то в Firefox выигрывает первое запущенное расширение. В Chrome выигрывает последнее. |
79Если два или более расширений определяют пользовательскую страницу новой вкладки, то в Firefox выигрывает первое запущенное расширение. В Edge выигрывает последнее. |
54Если два или более расширений определяют пользовательскую страницу новой вкладки, то в Firefox выигрывает первое запущенное расширение. В Chrome выигрывает последнее. |
? | Нет | 14.1Расширение может определить пользовательскую страницу новой вкладки или окна, но это не вступит в силу до тех пор, пока пользователь не выберет расширение для переопределения страницы в настройках Safari — Общие. |
? | ? | Нет | ? | 15Расширение может определить пользовательскую страницу новой вкладки или окна, но это не вступит в силу до тех пор, пока пользователь не выберет расширение для переопределения страницы в настройках 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/chrome_url_overrides
