chrome.topSites

refresh date: 2026-09-25 robots: noindex

Descrição

Use a API chrome.topSites para acessar os sites mais visitados que aparecem na página "Nova guia". Isso não inclui os atalhos personalizados pelo usuário.

Permissões

topSites

Manifesto

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

Promessa 
chrome.topSites.get(
  callback?: function,
): Promise<MostVisitedURL[]>

Recebe uma lista dos principais sites.

Parâmetros

Retorna

  • Promise<MostVisitedURL[]>

    Chrome 96 ou mais recente

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.