chrome.search

дата обновления: 2026-09-25 robots: noindex

Описание

Используйте API chrome.search для поиска через стандартный поисковый сервис.

Разрешения

search

Доступность

Chrome 87+

Типы

Disposition

Перечисление

"ТЕКУЩАЯ_ВКЛ."
Указывает, что результаты поиска должны отображаться на вкладке, с которой был совершен вызов, или на вкладке активного браузера.

"НОВАЯ_ВКЛАДКА"
Указывает, что результаты поиска должны отображаться в новой вкладке.

"NEW_WINDOW"
Указывает, что результаты поиска должны отображаться в новом окне.

QueryInfo

Характеристики

  • расположение

    Расположение ( по желанию)

    Место, где должны отображаться результаты поиска. По умолчанию используется CURRENT_TAB .

  • tabId

    число необязательно

    Место, где должны отображаться результаты поиска. tabId нельзя использовать с disposition .

  • текст

    нить

    Строка для запроса с использованием поставщика поиска по умолчанию.

Методы

query()

Обещать
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
): Promise<void>

Используется для запроса к поставщику поиска по умолчанию. В случае ошибки будет установлено значение runtime.lastError .

Параметры

  • queryInfo

    QueryInfo

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 96+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.