chrome.topSites

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

topSites

É necessário declarar a propriedade "topSites" permissão no manifesto da sua extensão para usar essa API.

{
  "name": "My extension",
  ...
  "permissions": [
    "topSites",
  ],
  ...
}

Exemplos

Para testar esta API, instale o exemplo da API topSites da biblioteca chrome-extension-samples repositório de dados.

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

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

Recebe uma lista dos principais sites.

Parâmetros

Retorna

  • Promise<MostVisitedURL[]>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.