Descrição
Use a API chrome.topSites
para acessar os principais sites (ou seja, os mais visitados) que são exibidos na página "Nova guia". Eles não incluem atalhos personalizados pelo usuário.
Permissões
topSites
É necessário 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 no 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
-
title
string
O título da página
-
url
string
O URL mais visitado.
Métodos
get()
chrome.topSites.get(
callback?: function,
)
Recebe uma lista dos principais sites.
Parâmetros
-
callback
função optional
O parâmetro
callback
tem esta aparência:(data: MostVisitedURL[]) => void
-
dados
-
Retorna
-
Promise<MostVisitedURL[]>
Chrome 96 ou mais recentePromessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.