Descripción
Usa la API de chrome.topSites para acceder a los sitios principales (es decir, los sitios más visitados) que se muestran en la página de nueva pestaña. No se incluyen los atajos personalizados por el usuario.
Permisos
topSitesManifiesto
Debes declarar el permiso "topSites" en el manifiesto de tu extensión para usar esta API.
{
"name": "My extension",
...
"permissions": [
"topSites",
],
...
}
Ejemplos
Para probar esta API, instala el ejemplo de la API de topSites desde el repositorio de chrome-extension-samples.
Tipos
MostVisitedURL
Es 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
Es la URL más visitada.
Métodos
get()
chrome.topSites.get(
callback?: function,
): Promise<MostVisitedURL[]>
Obtiene una lista de los sitios principales.
Parámetros
-
callback
función opcional
El parámetro
callbackse ve de la siguiente manera:(data: MostVisitedURL[]) => void
-
datos
-
Muestra
-
Promise<MostVisitedURL[]>
Chrome 96 y versiones posterioresLas promesas solo se admiten en Manifest V3 y versiones posteriores. Otras plataformas deben usar devoluciones de llamada.