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.