search.query()
Выполнить поиск с использованием стандартного поискового движка браузера.
Результаты отображаются в текущей вкладке, новой вкладке или новом окне в соответствии со свойством disposition или в вкладке, указанной в свойстве tabId. Если ни то, ни другое не указано, результаты отображаются в текущей вкладке.
Для использования этой функции ваша расширение должно иметь разрешение "search" разрешение манифеста.
Синтаксис
browser.search.query( queryInfo // object )
Параметры
queryInfo-
object. Объект со следующими свойствами:-
dispositionНеобязательно -
string. Место расположения отображения результатов поиска. Допустимые значения:CURRENT_TAB,NEW_TAB, иNEW_WINDOW. По умолчаниюCURRENT_TAB. Не может быть указано вместе сtabId. -
tabIdНеобязательно -
integer. Необязательный идентификатор вкладки, в которой вы хотите выполнить поиск. Если это свойство опущено, результаты поиска отображаются в новой вкладке. Не может быть указано вместе сdisposition. text-
string. Запрос поиска.
-
Возвращаемое значение
Ничего.
Примеры
Поиск с результатами, отображаемыми в текущей вкладке (по умолчанию):
function search() { browser.search.query({ text: "styracosaurus" }); } browser.browserAction.onClicked.addListener(search);
Поиск с результатами, отображаемыми в новом окне:
function search() { browser.search.query({ text: "styracosaurus", disposition: "NEW_WINDOW" }); } browser.browserAction.onClicked.addListener(search);
Поиск с результатами, отображаемыми в определённой вкладке:
function search(tab) { browser.search.query({ query: "styracosaurus", tabId: tab.id }); } browser.browserAction.onClicked.addListener(search);
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
query |
87 | 87 | 111 | ? | 73 | Нет | ? | ? | Нет | ? | Нет | ? |
queryInfo |
87 | 87 | 111 | ? | 73 | Нет | ? | ? | Нет | ? | Нет | ? |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/search/query