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 事件。