Substituir páginas do Chrome

As extensões podem usar páginas de substituição de HTML para substituir uma página fornecida pelo Google Chrome normalmente. Uma extensão pode conter uma substituição para qualquer uma das páginas a seguir, mas cada extensão só pode modificar uma página:

Gerenciador de favoritos

A página que aparece quando o usuário escolhe o item de menu "Gerenciador de favoritos" no menu do Google Chrome ou, no Mac, no item "Gerenciador de favoritos" no menu "Favoritos". Você também pode cheguem a essa página digitando o URL chrome://bookmarks.

Histórico

A página que aparece quando o usuário escolhe o item de menu "Histórico" no Chrome ou, no Mac, o item Mostrar histórico completo no menu Histórico. Você também pode acessar esta página digitando o URL chrome://history.

Nova guia

A página que aparece quando o usuário cria uma nova guia ou janela. Você também pode nesta página digitando o URL chrome://newtab.

As capturas de tela a seguir mostram a página "Nova guia" padrão e, em seguida, uma página "Nova guia" personalizada.

Para testar isso, consulte nossos exemplos de substituição.

Comportamento da janela anônima

Nas janelas anônimas, as extensões não podem substituir as páginas "Nova guia". Outras páginas ainda funcionam se a propriedade do manifesto de navegação anônima estiver Definido como "período" (o valor padrão). Para saber mais sobre como usar janelas anônimas, consulte Como salvar dados e modo de navegação anônima.

Manifesto

Use o código a seguir para registrar uma página de substituição no manifesto de extensões:

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

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

Por PAGE_TO_OVERRIDE, substitua uma das seguintes opções:

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

Práticas recomendadas

• Deixe sua página rápida e pequena.
  Os usuários esperam que as páginas integradas ao navegador abram instantaneamente. Evite fazer coisas que podem demorar muito tempo de resposta. Especificamente, evite acessar recursos de banco de dados de forma síncrona. Ao fazer solicitações de rede, prefira fetch() em vez de XMLHttpRequest().

• Para evitar que os usuários se confundam, dê um título à página.
  Sem um título, o título da página é padronizado com o URL. Especifique o título usando a tag <title> no arquivo HTML.

• Lembre-se de que as novas guias colocam o foco do teclado na barra de endereço primeiro.
  Não dependa do foco do teclado padronizado para outras partes da página.

• Personalizar a página "Nova guia".
  Evite criar uma página "Nova guia" que os usuários possam confundir com a página padrão do Chrome.

Exemplos

Consulte os exemplos de substituição.