Переопределить страницы Chrome

Расширения могут использовать страницы переопределения HTML для замены страницы, которую обычно предоставляет Google Chrome. Расширение может содержать переопределение для любой из следующих страниц, но каждое расширение может переопределять только одну страницу:

Менеджер закладок
Страница, которая появляется, когда пользователь выбирает пункт меню «Диспетчер закладок» в меню Chrome или, на Mac, пункт «Диспетчер закладок» в меню «Закладки». Вы также можете перейти на эту страницу, введя URL-адрес chrome://bookmarks .
История
Страница, которая появляется, когда пользователь выбирает пункт меню «История» в меню Chrome или, на Mac, пункт «Показать полную историю» в меню «История». Вы также можете перейти на эту страницу, введя URL-адрес chrome://history .
Новая вкладка
Страница, которая появляется, когда пользователь создает новую вкладку или окно. Вы также можете перейти на эту страницу, введя URL-адрес chrome://newtab .

На следующих снимках экрана показана страница новой вкладки по умолчанию, а затем пользовательская страница новой вкладки.

Страница новой вкладки по умолчанию
Страница новой вкладки по умолчанию.
Пользовательская страница новой вкладки
Пользовательская новая вкладка.

Чтобы попробовать это, ознакомьтесь с нашими примерами переопределения .

Поведение окна инкогнито

В окнах в режиме инкогнито расширения не могут переопределять страницы новой вкладки. Другие страницы по-прежнему работают, если для свойства манифеста инкогнито установлено значение «охват» (значение по умолчанию). Подробную информацию о том, как работать с окнами в режиме инкогнито, см. в разделе Сохранение данных и режим инкогнито .

Манифест

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

{
  "manifest_version": 3,
  "name": "My extension",
  ...

  "chrome_url_overrides" : {
    "PAGE_TO_OVERRIDE": "myPage.html"
  },
  ...
}

Вместо PAGE_TO_OVERRIDE замените одно из следующих:

  • "bookmarks"
  • "history"
  • "newtab"

Лучшие практики

  • Сделайте свою страницу быстрой и маленькой.
    Пользователи ожидают, что встроенные страницы браузера будут открываться мгновенно. Избегайте действий, которые могут занять много времени. В частности, избегайте синхронного доступа к ресурсам базы данных. При выполнении сетевых запросов отдавайте предпочтение fetch() вместо XMLHttpRequest() .

  • Чтобы избежать путаницы пользователей, дайте своей странице заголовок.
    Без заголовка заголовок страницы по умолчанию соответствует URL-адресу. Укажите заголовок с помощью тега <title> в HTML-файле.

  • Помните, что новые вкладки сначала переводят фокус клавиатуры на адресную строку.
    Не полагайтесь на то, что фокус клавиатуры по умолчанию переключится на другие части страницы.

  • Сделайте новую вкладку своей собственной.
    Не создавайте новую вкладку, которую пользователи могут спутать со страницей новой вкладки Chrome по умолчанию.

Примеры

См. примеры переопределения .