tabs.duplicate()

Dupliziert einen Tab anhand seiner ID.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let duplicating = browser.tabs.duplicate(
  tabId,              // integer
  duplicateProperties // optional object
)

Parameter

tabId

integer. Die ID des Tabs, der dupliziert werden soll.

duplicateProperties Optional

object. Ein Objekt, das beschreibt, wie der Tab dupliziert wird. Es enthält die folgenden Eigenschaften:

index Optional

integer. Die Position des neuen Tabs im Fenster. Der Wert ist auf den Bereich von null bis zur Anzahl der Tabs im Fenster beschränkt.

active Optional

boolean. Ob der Tab im Fenster zum aktiven Tab wird. Hat keinen Einfluss darauf, ob das Fenster fokussiert ist. Standardmäßig true.

Rückgabewert

Ein Promise, das mit einem tabs.Tab-Objekt erfüllt wird, das Details über den duplizierten Tab enthält. Das Tab-Objekt enthält nur url, title und favIconUrl, wenn die Erweiterung die "tabs" Berechtigung oder passende Host-Berechtigungen hat. Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung zurückgewiesen.

Hinweis: Ab Firefox 68 wird das Promise, das von browser.tabs.duplicate() zurückgegeben wird, unmittelbar aufgelöst, sobald der Tab dupliziert wurde. Zuvor wurde das Promise erst aufgelöst, wenn der Tab vollständig geladen war.

Beispiele

Duplizieren Sie den ersten Tab und protokollieren Sie dann die ID des neu erstellten Tabs:

js
function onDuplicated(tabInfo) {
  console.log(tabInfo.id);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

// Duplicate the first tab in the array
function duplicateFirstTab(tabs) {
  console.log(tabs);
  if (tabs.length > 0) {
    let duplicating = browser.tabs.duplicate(tabs[0].id);
    duplicating.then(onDuplicated, onError);
  }
}

// Query for all open tabs
let querying = browser.tabs.query({});
querying.then(duplicateFirstTab, onError);

Beispielerweiterungen

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf der chrome.tabs-API von Chromium. Diese Dokumentation stammt von tabs.json im Chromium-Code.