omnibox.setDefaultSuggestion()
Set the default suggestion to appear in the address bar drop-down list when the user starts interacting with your extension.
Once the user has entered your keyword and started interacting with your extension, the default suggestion will always appear first in the drop-down list. Unlike the suggestions you supply in omnibox.onInputChanged
, this item can't be selected. Use it to provide the user with some guidance about what to type and what they can expect to see when they do.
Syntax
browser.omnibox.setDefaultSuggestion(
suggestion // object
)
Parameters
Return value
None.
Browser compatibility
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
setDefaultSuggestion | ChromeFull supportYes | EdgeFull support79 | FirefoxFull support52
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Examples
browser.omnibox.setDefaultSuggestion({
description: "Type the name of a CSS property"
});
Example extensions
Acknowledgements
This API is based on Chromium's chrome.omnibox API.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.