chrome.search

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 aparecem 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 exibidos 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

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

Promise 
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 opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promise<void>

    Chrome 96+

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