Anular páginas de Chrome

Las extensiones pueden utilizar páginas de anulación HTML para reemplazar una página que Google Chrome suele proporcionar. 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

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

Historial

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

Pestaña nueva

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

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

La página predeterminada Nueva pestaña.

Página personalizada de nueva pestaña.

Si quieres probar esto, consulta nuestras muestras de anulación.

Comportamiento de las ventanas de incógnito

En las ventanas de incógnito, las extensiones no pueden anular las páginas Nueva pestaña. Otras páginas seguirán funcionando si la propiedad incógnito del manifiesto se configura como "spanning" (el valor predeterminado). Para obtener información detallada sobre cómo administrar las ventanas de incógnito, consulta Cómo guardar datos y el modo Incógnito.

Manifest

Utiliza el siguiente código para registrar una página de anulación en el manifiesto de extensión:

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

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

Para PAGE_TO_OVERRIDE, sustituye una de las siguientes opciones:

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

Prácticas recomendadas

• Haz que tu página sea rápida y pequeña.
  Los usuarios esperan que las páginas del navegador integradas se abran al instante. 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, prioriza fetch() en lugar de XMLHttpRequest().

• Para evitar que el usuario se confunda, asigna 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 priorizan 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 Nueva pestaña que los usuarios puedan confundir con la página Nueva pestaña predeterminada de Chrome.

Ejemplos

Consulta las muestras de anulación.