chrome.search

refresh date: 2026-09-25 robots: noindex

Описание

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

Разрешения

search

Доступность

Chrome 87 и более поздних версий;

Типы

Disposition

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

"CURRENT_TAB"
Результаты поиска показываются на вкладке, с которой был выполнен вызов, или на вкладке активного браузера.

"NEW_TAB"
Результаты поиска показываются на новой вкладке.

"NEW_WINDOW"
Результаты поиска показываются в новом окне.

QueryInfo

Свойства

  • disposition

    Disposition необязательный

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

  • tabId

    number (необязательно)

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

  • Текст

    string

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

Методы

query()

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

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

Параметры

  • queryInfo

    QueryInfo

  • обратный вызов

    function необязательно

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

    () => void

Возвраты

  • Promise<void>

    Chrome 96 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.