Spec-Zone.ru › Web Extensions

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API