Anular páginas de Chrome

Las extensiones pueden usar páginas de reemplazo de HTML para reemplazar una página que Google Chrome proporciona normalmente. Una extensión puede contener una anulación para cualquiera de las siguientes páginas, pero cada extensión solo puede anular una página:

Administrador de favoritos

Página que aparece cuando el usuario elige el elemento del menú Administrador de favoritos en el menú de Chrome o, en Mac, el elemento Administrador de favoritos en el menú Favoritos. También puedes acceder a esta página ingresando la URL chrome://bookmarks.

Historial

Página que aparece cuando el usuario elige el elemento de menú Historial en el menú de Chrome o, en Mac, el elemento Mostrar historial completo en el menú Historial. También puedes acceder a esta página ingresando la URL chrome://history.

Nueva pestaña

Es la página que aparece cuando el usuario crea una pestaña o ventana nueva. También puedes acceder a esta página ingresando la URL chrome://newtab.

En las siguientes capturas de pantalla, se muestran la página Nueva pestaña predeterminada y, luego, una página Nueva pestaña personalizada.

Para probar esto, consulta nuestros ejemplos de anulación.

Comportamiento de la ventana de incógnito

En las ventanas de incógnito, las extensiones no pueden anular las páginas de Nueva pestaña. Las demás páginas seguirán funcionando si la propiedad del manifiesto incognito se establece en "split" (el valor predeterminado). Para obtener detalles sobre cómo controlar las ventanas de incógnito, consulta Cómo guardar datos y el modo Incógnito.

Manifiesto

Usa el siguiente código para registrar una página de reemplazo en el manifiesto de la extensión:

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

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

Para PAGE_TO_OVERRIDE, sustituye uno de los siguientes valores:

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

Prácticas recomendadas

• Haz que tu página sea rápida y liviana.
  Los usuarios esperan que las páginas integradas del navegador se abran de forma instantánea. Evita hacer cosas que puedan llevar mucho tiempo. Específicamente, evita acceder a los recursos de la base de datos de forma síncrona. Cuando realices solicitudes de red, prefiere fetch() en lugar de XMLHttpRequest().

• Para evitar confusiones, asígnale un título a tu página.
  Sin un título, el título de la página se establece de forma predeterminada en la URL. Especifica el título con la etiqueta <title> en tu archivo HTML.

• Recuerda que las pestañas nuevas enfocan primero la barra de direcciones con el teclado.
  No confíes en que el enfoque del teclado se establezca de forma predeterminada en otras partes de la página.

• Personaliza la página Nueva pestaña.
  Evita crear una página de nueva pestaña que los usuarios puedan confundir con la página de nueva pestaña predeterminada de Chrome.

Ejemplos

Consulta los ejemplos de anulaciones.