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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
discard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Hinweis: Diese API basiert auf Chromiums chrome.tabs API.