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

js
let discarding = browser.tabs.discard(
  tabIds          // integer or integer array
)

Parameter

tabIds

integer oder array von integer. 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:

js
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:

js
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.