search.search()
Führen Sie eine Suche mit der angegebenen Suchmaschine oder der Standardsuchmaschine durch, wenn keine Suchmaschine angegeben ist.
Die Ergebnisse werden im aktuellen Tab, einem neuen Tab oder einem neuen Fenster entsprechend der Eigenschaft disposition oder im in der Eigenschaft tabId angegebenen Tab angezeigt. Wenn keine von beiden angegeben ist, werden die Ergebnisse in einem neuen Tab angezeigt.
Um diese Funktion zu nutzen, muss Ihre Erweiterung die Berechtigung "search" im Manifest besitzen.
Um die installierten Suchmaschinen zu erhalten, verwenden Sie search.get().
Syntax
browser.search.search(
searchProperties // object
)
Parameter
searchProperties-
object. Ein Objekt mit den folgenden Eigenschaften:dispositionOptional-
string. Der Ort, an dem die Suchergebnisse angezeigt werden. Gültige Werte sindCURRENT_TAB,NEW_TABundNEW_WINDOW. StandardmäßigNEW_TAB. Kann nicht zusammen mittabIdangegeben werden. engineOptional-
string. Der Name der Suchmaschine. Wenn der Name der Suchmaschine nicht existiert, lehnt die Funktion den Aufruf mit einem Fehler ab. Wenn diese Eigenschaft weggelassen wird, wird die Standardsuchmaschine verwendet. query-
string. Die Suchanfrage. tabIdOptional-
integer. Eine optionale Kennung für den Tab, in dem Sie die Suche ausführen möchten. Wenn diese Eigenschaft weggelassen wird, werden die Suchergebnisse in einem neuen Tab angezeigt. Kann nicht zusammen mitdispositionangegeben werden.
Rückgabewert
Keiner.
Beispiele
Eine Suche mit der Standardsuchmaschine, wobei die Ergebnisse im aktuellen Tab angezeigt werden (Standard):
function search() {
browser.search.search({
query: "styracosaurus",
});
}
browser.browserAction.onClicked.addListener(search);
Eine Suche mit Wikipedia, wobei die Ergebnisse in einem neuen Fenster angezeigt werden:
async function search() {
try {
// try to search using the `Wikipedia (en)` search engine
await browser.search.search({
query: "styracosaurus",
engine: "Wikipedia (en)",
disposition: "NEW_WINDOW",
});
} catch (ex) {
// if the search fails, e.g., because the search engine isn't defined to the browser, initiate the search using a url
await browser.windows.create({
url: "https://en.wikipedia.org/w/index.php?title=Special:Search&search=styracosaurus",
});
}
}
browser.browserAction.onClicked.addListener(search);
Eine Suche mit Wikipedia, wobei die Ergebnisse im aktuellen Tab angezeigt werden:
async function search(tab) {
try {
// try to search using the `Wikipedia (en)` search engine
await browser.search.search({
query: "styracosaurus",
engine: "Wikipedia (en)",
tabId: tab.id,
});
} catch (ex) {
// if the search fails, e.g., because the search engine isn't defined to the browser, initiate the search using a url
await browser.tabs.update(tab.id, {
url: "https://en.wikipedia.org/w/index.php?title=Special:Search&search=styracosaurus",
});
}
}
browser.browserAction.onClicked.addListener(search);