Anula páginas de Chrome

Las páginas de anulación son una forma de sustituir un archivo HTML de tu extensión por una página que Google Chrome suele proporcionar. Además de HTML, una página de anulación generalmente tiene código CSS y JavaScript.

Una extensión puede reemplazar cualquiera de las siguientes páginas:

  • Administrador de favoritos: Es 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 del 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.
  • 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 si ingresas la URL chrome://newtab.
Nota: Una extensión puede anular solo una página. Por ejemplo, una extensión no puede anular las páginas Administrador de favoritos y Historial.

Las ventanas de incógnito se tratan de manera especial. Las páginas Nueva pestaña no se pueden anular en las ventanas de incógnito. Otras páginas de anulación funcionan en ventanas de incógnito, siempre y cuando la propiedad del manifiesto incógnito esté configurada como "spanning" (el valor predeterminado). Consulta Cómo guardar datos y el modo Incógnito en la Descripción general para obtener más detalles sobre cómo debes tratar las ventanas de incógnito.

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

Manifest

Registra una página de anulación en el manifiesto de extensión de la siguiente manera:

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

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

Para PAGE_TO_OVERRIDE, sustituye una de las siguientes opciones:

  • bookmarks
  • history
  • newtab

Sugerencias

Para obtener una página de anulación eficaz, sigue estos lineamientos:

  • 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. Por ejemplo, evita las recuperaciones síncronas de recursos de red o de base de datos.
  • Incluye un título en tu página. De lo contrario, las personas podrían ver la URL de la página, lo que podría resultar confuso. A continuación, se muestra un ejemplo para especificar el título: <title>New Tab</title>.
  • No confíes en que la página esté enfocada en el teclado. La barra de direcciones siempre se enfoca en primer lugar cuando el usuario crea una pestaña nueva.
  • No intentes emular la página Nueva pestaña predeterminada. Las APIs necesarias para crear una versión ligeramente modificada de la página Nueva pestaña predeterminada (con páginas principales, páginas cerradas recientemente, sugerencias, una imagen de fondo de tema, etc.) aún no existen. Hasta que lo hagan, lo mejor es tratar de hacer algo completamente diferente.

Ejemplos

Consulta las muestras de anulación.