chrome.search

Descrição

Use a API chrome.search para pesquisar usando o provedor padrão.

Permissões

search

Disponibilidade

Chrome 87 ou superior

Tipos

Disposition

Enumeração

"CURRENT_TAB"
Especifica que os resultados da pesquisa são exibidos na guia da chamada ou na guia do navegador ativo.

"NEW_TAB"
Especifica que os resultados da pesquisa são exibidos em uma nova guia.

"NEW_WINDOW"
Especifica que os resultados da pesquisa serão exibidos em uma nova janela.

QueryInfo

Propriedades

  • disposition

    Disposição opcional

    Local onde os resultados da pesquisa devem ser exibidos. CURRENT_TAB é o padrão.

  • tabId

    número opcional

    Local onde os resultados da pesquisa devem ser exibidos. tabId não pode ser usado com disposition.

  • texto

    string

    String a ser consultada com o provedor de pesquisa padrão.

Métodos

query()

Promessa 
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
)

Usado para consultar o provedor de pesquisa padrão. Em caso de erro, runtime.lastError será definido.

Parâmetros

  • queryInfo

    QueryInfo

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    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.