欢迎 What's new in Chrome extensions Get help with Chrome extensions API reference Samples
欢迎 What's new in Chrome extensions Get help with Chrome extensions API reference Samples

chrome.search

  • Description

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

  • Permissions
    search
  • Availability
    Chrome 87+

Summary

Types

Disposition

Type

"CURRENT_TAB"

,

"NEW_TAB"

,
or

"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

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

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

Parameters

  • 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.

We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.