Enables extensions to implement customised behavior when the user types into the browser's address bar.
When the user focuses the browser's address bar and starts typing, the browser displays a drop-down list containing suggested pages, based on what they typed. This gives the user a quick way to access, for example, pages from their history or bookmarks.
The omnibox API provides the extension a way to customise the suggestions displayed in the drop-down, when the user enters a keyword defined by the extension. It works as follows:
- First, the extension must include an "omnibox" key in its manifest.json file, which defines a keyword. Optionally, the extension can also call
omnibox.setDefaultSuggestion()to define the first suggestion that will be displayed in the address bar drop-down.
- When the user focuses the address bar and types the keyword, followed by a space, the extension will get an
- As the user continues to type characters after this, the extension will get
omnibox.onInputChangedevents. The event listener will be passed the current value the user has typed, and will be able to populate the address bar drop-down with suggestions. If the extension set a default suggestion using
omnibox.setDefaultSuggestion(), then this will appear first in the drop-down.
- If the user accepts a suggestion, the extension will get an
omnibox.onInputEnteredevent. The event listener will be passed the accepted suggestion.
- If the user dismisses the drop-down, the extension will get an
- Describes the recommended method to handle the selected suggestion: open in the current tab, open in a new foreground tab, or open in a new background tab.
- Object representing a suggestion to add to the address bar drop-down.
- Defines the first suggestion that appears in the drop-down when the user enters the keyword for your extension, followed by a space.
- Fired when a the user focuses the address bar and types your extension's omnibox keyword, followed by a space.
- Fired whenever the user's input changes, after they have focused the address bar and typed your extension's omnibox keyword, followed by a space.
- Fired when the user accepts one of your extension's suggestions.
- Fired when the user dismisses the address bar drop-down, after they have focused the address bar and typed your extension's omnibox keyword.
|Chrome||Edge||Firefox||Firefox for Android||Opera|
The "Chrome incompatibilities" section is included from https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities using the WebExtChromeCompat macro.
If you need to update this content, edit https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Chrome_incompatibilities, then shift-refresh this page to see your changes.
This API is based on Chromium's
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.