chrome.search

refresh date: 2026-09-25 robots: noindex

Descrição

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

Permissões

search

Disponibilidade

Chrome 87 ou mais recente

Tipos

Disposition

Enumeração

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

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

"NEW_WINDOW"
Especifica que os resultados da pesquisa são mostrados em uma nova janela.

QueryInfo

Propriedades

  • disposition

    Disposição opcional

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

  • tabId

    número optional

    Local onde os resultados da pesquisa devem ser mostrados. Não é possível usar tabId com disposition.

  • texto

    string

    String para consultar com o provedor de pesquisa padrão.

Métodos

query()

Promessa 
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
): Promise<void>

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

Parâmetros

  • queryInfo

    QueryInfo

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    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.