downloads.search()
Die Funktion search() der downloads API durchsucht die DownloadItems, die im Download-Manager des Browsers verfügbar sind, und gibt diejenigen zurück, die den angegebenen Suchkriterien entsprechen.
Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.
Syntax
let searching = browser.downloads.search(query);
Parameter
query-
Ein
downloads.DownloadQueryObjekt.
Rückgabewert
Ein Promise. Das Promise wird mit einem array von downloads.DownloadItem Objekten erfüllt, die den gegebenen Kriterien entsprechen.
Beispiele
Im Allgemeinen beschränken Sie die abgerufenen Elemente mit dem query-Parameter.
Downloads abrufen, die "query" entsprechen
function logDownloads(downloads) {
for (const download of downloads) {
console.log(download.id);
console.log(download.url);
}
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.downloads
.search({
query: ["imgur"],
})
.then(logDownloads, onError);
Ein bestimmtes Element abrufen
Um ein bestimmtes DownloadItem abzurufen, ist es am einfachsten, nur das id-Feld zu setzen, wie im folgenden Codeausschnitt gezeigt:
function logDownloads(downloads) {
for (const download of downloads) {
console.log(download.id);
console.log(download.url);
}
}
function onError(error) {
console.log(`Error: ${error}`);
}
const id = 13;
browser.downloads.search({ id }).then(logDownloads, onError);
Alle Downloads abrufen
Wenn Sie alle DownloadItems zurückgeben möchten, setzen Sie query auf ein leeres Objekt.
function logDownloads(downloads) {
for (const download of downloads) {
console.log(download.id);
console.log(download.url);
}
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.downloads.search({}).then(logDownloads, onError);
Den letzten Download abrufen
Sie können den neuesten Download abrufen, indem Sie die folgenden Suchparameter angeben:
function logDownloads(downloads) {
for (const download of downloads) {
console.log(download.id);
console.log(download.url);
}
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.downloads
.search({
limit: 1,
orderBy: ["-startTime"],
})
.then(logDownloads, onError);
Sie können diesen Code in unserem latest-download Beispiel in Aktion sehen.
Beispielerweiterungen
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf der chrome.downloads API von Chromium.