chrome.search
- Description
Use the
chrome.searchAPI to search via the default provider. - Permissions
search - AvailabilityChrome 87+
Summary
- Types
- Methods
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_TABis the default. - tabId
number optional
Location where search results should be displayed.
tabIdcannot 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
callbackparameter 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.