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 que Chrome suele proporcionar. Además de HTML, una página de anulación suele tener 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 Administrador de favoritos en el 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 elige el elemento de menú Historial en 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.
Nota: Una sola 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 forma 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 de Incógnito se encuentre establecido en "intervalo" (que es el valor predeterminado). Consulta Cómo guardar datos y en 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 Nueva pestaña predeterminada

Una página Nueva pestaña personalizada

Manifiesto

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, reemplaza una de las siguientes opciones:

  • bookmarks
  • history
  • newtab

Sugerencias

Para que la página de anulación sea efectiva, 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 de inmediato. Evita hacer cosas que podrían tardar mucho tiempo. Por ejemplo, evita las recuperaciones síncronas de los recursos de red o base de datos.
  • Incluye un título en tu página. De lo contrario, los usuarios podrían ver la URL de la página, lo que podría resultar confuso. Aquí hay un ejemplo de que especifica el título: <title>New Tab</title>
  • No confíes en que la página tenga el enfoque del teclado. La barra de direcciones siempre se enfoca primero 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 la parte superior las páginas, las páginas cerradas recientemente, las sugerencias, la imagen de fondo de un tema, etc., no existen todavía. Hasta lo hacen, es mejor que trates de hacer algo completamente diferente.

Ejemplos

Consulta los ejemplos de anulación.