omnibox

允许扩展实现当用户在浏览器的地址栏输入时的自定义行为。

当用户聚焦地址栏并开始输入时，浏览器会显示一个下拉菜单，其中包含基于用户输入的建议页面。这使用户可以快速访问，例如，他们的历史记录或书签中的页面。

当用户输入扩展定义的关键字时，omnibox API 为扩展提供了一种自定义显示在下拉菜单中的建议的方法。它是这样工作的：

1. 首先，扩展必须在其 manifest.json 文件中包含“omnibox”键，其用于定义一个关键字。
2. 当用户聚焦地址栏，输入扩展定义的关键字以及一个空格后，扩展会收到一个 omnibox.onInputStarted 事件。
3. 可选地，扩展可以调用 omnibox.setDefaultSuggestion() 来定义显示在地址栏下拉菜单中的第一个建议。
4. 当用户继续输入字符时，扩展将收到 omnibox.onInputChanged 事件。事件监听器将传入用户输入的值，并可以使用建议填充地址栏下拉菜单。如果扩展使用 omnibox.setDefaultSuggestion() 设置了默认建议，则该建议将显示在下拉菜单中的第一项处。
5. 当用户接受建议时，扩展将收到一个 omnibox.onInputEntered 事件。事件监听器将传入接受的建议。
6. 当用户删除建议时，扩展将收到一个 omnibox.onDeleteSuggestion 事件。
7. 当用户关闭下拉菜单时，扩展将收到一个 omnibox.onInputCancelled 事件。