tabs.discard()
Verwirft einen oder mehrere Tabs.
Einige Browser "verwerfen" automatisch nicht genutzte Tabs, um Speicher freizugeben. Verwirrte Tabs bleiben im Tabstreifen sichtbar. Der Browser speichert den Zustand des Tabs und stellt ihn wieder her, wenn der Benutzer den Tab auswählt. Die Details, wann Tabs verworfen werden und was verworfen wird, sind browserspezifisch.
Sie können steuern, ob der Browser oder diese API einen Tab verwirft, indem Sie dessen autoDiscardable
-Eigenschaft in tabs.update
auf false
setzen. Diese Einstellung verhindert, dass der Browser den Tab verwirft. Der Tab kann dann nur mit dieser API verworfen werden.
Es ist nicht möglich, den aktiven Tab oder einen Tab zu verwerfen, dessen Dokument einen beforeunload
Listener enthält, der eine Eingabeaufforderung anzeigen würde.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
let discarding = browser.tabs.discard(
tabIds // integer or integer array
)
Parameter
tabIds
-
integer
oderarray
voninteger
. Die IDs des Tabs oder der Tabs, die verworfen werden sollen.
Rückgabewert
Ein Promise
, das ohne Argumente erfüllt wird, wenn alle angegebenen Tabs verworfen wurden. Wenn ein Fehler auftritt (zum Beispiel ungültige Tab-IDs), wird das Promise mit einer Fehlermeldung abgelehnt.
Wenn die ID des aktiven Tabs übergeben wird, wird er nicht verworfen, aber das Promise wird erfüllt und alle anderen übergebenen Tabs werden verworfen.
Beispiele
Einen einzelnen Tab verwerfen:
function onDiscarded() {
console.log(`Discarded`);
}
function onError(error) {
console.log(`Error: ${error}`);
}
let discarding = browser.tabs.discard(2);
discarding.then(onDiscarded, onError);
Mehrere Tabs verwerfen:
function onDiscarded() {
console.log(`Discarded`);
}
function onError(error) {
console.log(`Error: ${error}`);
}
let discarding = browser.tabs.discard([15, 14, 1]);
discarding.then(onDiscarded, onError);
Browser-Kompatibilität
BCD tables only load in the browser
Hinweis: Diese API basiert auf Chromiums chrome.tabs
API.