tabs.create()
Erstellt einen neuen Tab.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
let creating = browser.tabs.create(
createProperties // object
)
Parameter
createProperties
-
object
. Eigenschaften, die dem neuen Tab zugewiesen werden sollen. Um mehr über diese Eigenschaften zu erfahren, lesen Sie dietabs.Tab
Dokumentation.active
Optional-
boolean
. Gibt an, ob der Tab der aktive Tab im Fenster werden soll. Wennfalse
, hat dies keine Auswirkung. Es beeinflusst nicht, ob das Fenster fokussiert ist (siehewindows.update
). Standardwert isttrue
. -
string
. Verwenden Sie dies, um einen Tab zu erstellen, dessen Cookie-Store-IDcookieStoreId
ist. Diese Option ist nur verfügbar, wenn die Erweiterung die"cookies"
Berechtigung hat. Weitere Informationen finden Sie unter Arbeiten mit kontextuellen Identitäten. discarded
Optional-
boolean
. Gibt an, ob der Tab erstellt und in der Tableiste sichtbar gemacht werden soll, ohne dass Inhalte in den Speicher geladen werden, ein Zustand, der als "discarded" bekannt ist. Die Inhalte des Tabs werden geladen, wenn der Tab aktiviert wird. index
Optional-
integer
. Die Position, die der Tab im Fenster einnehmen soll. Der angegebene Wert wird zwischen null und der Anzahl der Tabs im Fenster begrenzt. muted
Optional-
boolean
. Gibt an, ob der Tab stummgeschaltet sein soll. Standardwert istfalse
. openerTabId
Optional-
integer
. Die ID des Tabs, der diesen Tab geöffnet hat. Falls angegeben, muss sich der übergeordnete Tab im gleichen Fenster wie der neu erstellte Tab befinden. openInReaderMode
Optional-
boolean
. Wenntrue
, öffnet diesen Tab im Reader-Modus. Standardwert istfalse
. pinned
Optional-
boolean
. Gibt an, ob der Tab angeheftet werden soll. Standardwert istfalse
. selected
Optional-
boolean
. Gibt an, ob der Tab der ausgewählte Tab im Fenster werden soll. Standardwert isttrue
.Warnung: Diese Eigenschaft ist veraltet und wird in Firefox nicht unterstützt. Verwenden Sie stattdessen
active
. title
Optional-
string
. Der Titel des Tabs. Nur erlaubt, wenn der Tab mitdiscarded
auftrue
erstellt wird. url
Optional-
string
. Die URL, zu der der Tab anfangs navigieren soll. Standardwert ist die Neue-Tab-Seite.Vollqualifizierte URLs müssen ein Schema enthalten (z. B. 'http://www.google.com' statt 'www.google.com').
Aus Sicherheitsgründen kann in Firefox keine privilegierte URL verwendet werden. Das Weitergeben der folgenden URLs führt daher zu einem Fehler:
- chrome: URLs
- javascript: URLs
- data: URLs
- file: URLs (d. h. Dateien im Dateisystem. Um eine Datei zu verwenden, die in die Erweiterung gepackt ist, siehe unten)
- Privilegierte about: URLs (z. B.
about:config
,about:addons
,about:debugging
). Nicht-privilegierte URLs (z. B.about:blank
) sind erlaubt. - Die Neue-Tab-Seite (
about:newtab
) kann geöffnet werden, wenn kein Wert für die URL angegeben wurde.
Um eine Datei zu laden, die mit Ihrer Erweiterung gepackt ist, geben Sie eine absolute URL relativ zur Datei manifest.json der Erweiterung an. Zum Beispiel: '/path/to/my-page.html'. Wenn Sie das führende '/' weglassen, wird die URL als relative URL behandelt, und verschiedene Browser können unterschiedliche absolute URLs konstruieren.
windowId
Optional-
integer
. Das Fenster, in dem der neue Tab erstellt werden soll. Standardwert ist das aktuelle Fenster.
Rückgabewert
Ein Promise
, das mit einem tabs.Tab
Objekt erfüllt wird, das Details über den erstellten Tab enthält. Wenn der Tab nicht erstellt werden konnte (zum Beispiel, weil url
ein privilegiertes Schema verwendet hat), wird das Promise mit einer Fehlermeldung abgelehnt.
Das durch browser.tabs.create()
zurückgegebene Promise wird erfüllt, sobald der Tab erstellt wurde. Der Tab kann noch in der Ladephase sein. Um zu erkennen, wann der Tab fertig geladen ist, lauschen Sie dem tabs.onUpdated
oder dem webNavigation.onCompleted
Ereignis, bevor Sie tabs.create
aufrufen.
Beispiele
"Https://example.org" in einem neuen Tab öffnen:
function onCreated(tab) {
console.log(`Created new tab: ${tab.id}`);
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.browserAction.onClicked.addListener(() => {
let creating = browser.tabs.create({
url: "https://example.org",
});
creating.then(onCreated, onError);
});
Beispielerweiterungen
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
create | |||||||
active | |||||||
cookieStoreId | |||||||
discarded | |||||||
index | |||||||
muted | |||||||
openInReaderMode | |||||||
openerTabId | |||||||
pinned | |||||||
selected | |||||||
title | |||||||
url | |||||||
windowId |
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 der chrome.tabs
API von Chromium. Diese Dokumentation stammt aus tabs.json
im Chromium-Code.