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

Tipo enumerado

"CURRENT_TAB"
Especifica que os resultados da pesquisa são exibidos na guia de 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 sã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 é definido.

Parâmetros

  • queryInfo
  • callback

    função optional

    O parâmetro callback tem esta aparência:

    ()=>void

Retorna

  • Promise<void>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.