Anular páginas de Chrome

Las extensiones pueden usar páginas de anulación de 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

La página que aparece cuando el usuario elige el elemento de 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

La página que aparece cuando el usuario selecciona el elemento de menú Historial 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.

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 ingresando 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.

Para probar esto, consulta nuestras muestras de anulación.

Comportamiento de la ventana de incógnito

En las ventanas de incógnito, las extensiones no pueden anular las páginas Nueva pestaña. Otras páginas aún funcionan si la propiedad del manifiesto de incógnito es establecido en "intervalo" (el valor predeterminado). Para obtener más información 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 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, reemplaza 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 de inmediato. Evita hacer cosas que podrían tardar 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 los usuarios se confundan, agrega un título a tu página.
  Sin título, el título de la página predeterminado es la URL. Especifica el título con la etiqueta <title> en tu archivo HTML.

• Recuerda que las pestañas nuevas enfocan el teclado primero en la barra de direcciones.
  No confíes en que el enfoque del teclado se muestre 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 los ejemplos de anulación.