Descrição
Use a API chrome.topSites para acessar os principais sites (ou seja, os mais visitados) que aparecem na página "Nova guia". Eles não incluem atalhos personalizados pelo usuário.
Permissões
topSitesManifesto
Você precisa declarar a permissão "topSites" no manifesto da extensão para usar essa API.
{
"name": "My extension",
...
"permissions": [
"topSites",
],
...
}
Exemplos
Para testar essa API, instale o exemplo da API topSites do repositório chrome-extension-samples.
Tipos
MostVisitedURL
Um objeto que encapsula um URL mais visitado, como os atalhos padrão na página "Nova guia".
Propriedades
-
título
string
O título da página
-
url
string
O URL mais visitado.
Métodos
get()
chrome.topSites.get(
callback?: function,
): Promise<MostVisitedURL[]>
Recebe uma lista dos principais sites.
Parâmetros
-
callback
função opcional
O parâmetro
callbacktem esta aparência:(data: MostVisitedURL[]) => void
-
dados
-
Retorna
-
Promise<MostVisitedURL[]>
Chrome 96+As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.