search.search()

Effectuer une recherche en utilisant le moteur de recherche spécifié, ou le moteur de recherche par défaut si aucun moteur de recherche n'est spécifié.

Les résultats seront affichés dans un nouvel onglet, ou si l'argument tabId est donné, dans l'onglet identifié par ceci.

Pour utiliser cette fonction dans votre extension, vous devez demander la permission manifest "search".

Pour obtenir les moteurs de recherche installés, utilisez search.get().

Syntaxe

browser.search.search(
  searchProperties, // object
);

Paramètres

searchProperties

object. Un objet avec les propriétés suivantes :

query: string. La requête de recherche.
engineFacultatif: string. Le nom du moteur de recherche. Si le nom du moteur de recherche que vous spécifiez n'existe pas, la fonction lance une erreur. Si cette propriété est omise, le moteur de recherche par défaut sera utilisé.
tabIdFacultatif: integer. Un identificateur facultatif pour l'onglet dans lequel vous voulez exécuter la recherche. Si cette propriété est omise, les résultats de la recherche seront affichés dans un nouvel onglet.

Valeur retournée

Aucune

Compatibilité des navigateurs

BCD tables only load in the browser

Exemples

Recherche à l'aide du moteur de recherche par défaut. Les résultats seront affichés dans un nouvel onglet :

function search() {
  browser.search.search({
    query: "styracosaurus",
  });
}

browser.browserAction.onClicked.addListener(search);

Recherche à l'aide de Wikipédia. Les résultats seront affichés dans un nouvel onglet :

function search() {
  browser.search.search({
    query: "styracosaurus",
    engine: "Wikipedia (en)",
  });
}

browser.browserAction.onClicked.addListener(search);

Recherche à l'aide de Wikipédia. Les résultats seront affichés dans un nouvel onglet

function search(tab) {
  browser.search.search({
    query: "styracosaurus",
    engine: "Wikipedia (en)",
    tabId: tab.id,
  });
}

browser.browserAction.onClicked.addListener(search);

Example extensions

menu-search