chrome.topSites

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()

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

Recebe uma lista dos principais sites.

Parâmetros

Retorna

  • Promise<MostVisitedURL[]>

    Chrome 96 ou mais recente

    Promessas 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.