tabs.duplicate()
Dupliziert einen Tab, basierend auf 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 zu duplizierenden Tabs. duplicateProperties
Optional-
object
. Ein Objekt, das beschreibt, wie der Tab dupliziert wird. Es enthält folgende 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 begrenzt. active
Optional-
boolean
. Ob der Tab zum aktiven Tab im Fenster wird. Beeinflusst nicht, ob das Fenster fokussiert ist. Standardmäßig ist estrue
.
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 Berechtigung "tabs"
oder passende Host-Berechtigungen hat. Tritt ein Fehler auf, wird das Promise mit einer Fehlermeldung abgelehnt.
Hinweis:
Ab Firefox 68 wird das von browser.tabs.duplicate()
zurückgegebene Promise 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
Hinweis:
Diese API basiert auf der chrome.tabs
-API von Chromium. Diese Dokumentation ist abgeleitet von tabs.json
im Chromium-Code.