tabs.create()

Erstellt einen neuen Tab.

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

Syntax

js
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 die tabs.Tab Dokumentation.

active Optional

boolean. Gibt an, ob der Tab der aktive Tab im Fenster werden soll. Wenn false, hat dies keine Auswirkung. Es beeinflusst nicht, ob das Fenster fokussiert ist (siehe windows.update). Standardwert ist true.

cookieStoreId Optional

string. Verwenden Sie dies, um einen Tab zu erstellen, dessen Cookie-Store-ID cookieStoreId 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 ist false.

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. Wenn true, öffnet diesen Tab im Reader-Modus. Standardwert ist false.

pinned Optional

boolean. Gibt an, ob der Tab angeheftet werden soll. Standardwert ist false.

selected Optional

boolean. Gibt an, ob der Tab der ausgewählte Tab im Fenster werden soll. Standardwert ist true.

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 mit discarded auf true 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:

js
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 GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
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.