Omnibox

Разрешает расширениям реализовывать настраиваемое поведение при вводе пользователем текста в адресную строку браузера.

Когда пользователь фокусирует адресную строку браузера и начинает вводить текст, браузер отображает раскрывающееся меню с предложенными страницами на основе введённого текста. Это предоставляет пользователю быстрый способ доступа, например, к страницам из истории или закладок.

API omnibox предоставляет расширению возможность настраивать предложения, отображаемые в раскрывающемся меню, когда пользователь вводит ключевое слово, определённое расширением. Работает следующим образом:

1. Сначала расширение должно включить ключ "omnibox" в файле manifest.json, который определяет ключевое слово.
2. Когда пользователь фокусирует адресную строку и вводит ключевое слово, за которым следует пробел, расширение получает событие omnibox.onInputStarted.
3. По желанию расширение может вызвать omnibox.setDefaultSuggestion(), чтобы определить первое предложение, отображаемое в раскрывающемся меню адресной строки.
4. По мере продолжения ввода символов пользователем расширение получает события omnibox.onInputChanged. Обработчик событий получает значение, введённое пользователем, и может заполнить раскрывающееся меню адресной строки предложениями. Если расширение устанавливает значение по умолчанию с помощью omnibox.setDefaultSuggestion(), это предложение отображается первым в раскрывающемся меню.
5. Если пользователь принимает предложение, расширение получает событие omnibox.onInputEntered. Обработчик событий получает принятое предложение.
6. Если пользователь удаляет предложение, расширение получает событие omnibox.onDeleteSuggestion.
7. Если пользователь закрывает раскрывающееся меню, расширение получает событие omnibox.onInputCancelled.