tabs.duplicate()
Dupliziert einen Tab anhand seiner ID.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
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äßigtrue
.
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:
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.