chrome.search
- Description
Use the
chrome.search
API to search via the default provider. - Permissions
search
- AvailabilityChrome 87+
Summary
- Types
- Methods
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 withdisposition
. - text
string
String to query with the default search provider.
Methods
query
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
- 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.