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

Manifiesto

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 solo son compatibles con Manifest V3 y versiones posteriores; otras plataformas deben usar devoluciones de llamada.