chrome.topSites

Descripción

Usa la API de chrome.topSites para acceder a los sitios principales (es decir, los más visitados) que se muestran en la página Nueva pestaña. Estas no incluyen combinaciones de teclas personalizadas por el usuario.

Permisos

topSites

Debe declarar los "topSites" permiso en el manifiesto de la extensión para utilizar esta API.

{
  "name": "My extension",
  ...
  "permissions": [
    "topSites",
  ],
  ...
}

Ejemplos

Para probar esta API, instala el ejemplo de la API de topSites desde chrome-extension-samples en un repositorio de confianza.

Tipos

MostVisitedURL

Un objeto que encapsula una URL más visitada, como los accesos directos predeterminados en la página Nueva pestaña.

Propiedades

  • título

    string

    El título de la página

  • url

    string

    La URL más visitada.

Métodos

get()

Promesa 
chrome.topSites.get(
  callback?: function,
)

Obtiene una lista de los sitios principales.

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (data: MostVisitedURL[]) => void

Muestra

  • Promise<MostVisitedURL[]>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para retrocompatibilidad. No puedes usar ambos en la misma llamada a función. El se resuelve con el mismo tipo que se pasa a la devolución de llamada.