chrome.search

Description

Use the chrome.search API to search via the default provider.

Permissions

search

Availability

Chrome 87+

Types

Disposition

Enum

"CURRENT_TAB"
Specifies that the search results display in the calling tab or the tab from the active browser.

"NEW_TAB"
Specifies that the search results display in a new tab.

"NEW_WINDOW"
Specifies that the search results display in a new window.

QueryInfo

Properties

• disposition

  Disposition optional

  Location where search results should be displayed. CURRENT_TAB is the default.

• tabId

  number optional

  Location where search results should be displayed. tabId cannot be used with disposition.

• text

  string

  String to query with the default search provider.

Methods

query()

Promise

chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
)

Used to query the default search provider. In case of an error, runtime.lastError will be set.

Parameters

• queryInfo

  QueryInfo

• callback

  function optional

  The callback parameter looks like:

  () => void

Returns

• Promise<void>

  Chrome 96+

  Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback.