Crée un nouvel onglet
C'est une fonction asynchrone qui renvoie une Promise
.
Syntaxe
var creating = browser.tabs.create(
createProperties // object
)
Paramètres
createProperties
object
.Propriétés pour donner le nouvel onglet. Pour en savoir plus sur ces propriétés, consultez la documentationtabs.Tab
.-
active
Facultatifboolean
. Si l'onglet doit devenir l'onglet actif dans la fenêtre. Si elle estfalse
, elle n'a aucun effet. N'affecte pas si la fenêtre est mise au point (voirwindows.update
). Par défaut àtrue
.cookieStoreId
Facultatifstring
. Utilisez-le pour créer un onglet dont l'ID de cookie estCette option n'est disponible que si l'extension a la permission"cookies".
index
Facultatifinteger
. La position que l'onglet devrait prendre dans la fenêtre. La valeur fournie sera comprise entre zéro et le nombre d'onglets dans la fenêtre.openerTabId
Facultatifinteger
. L'ID de l'onglet qui a ouvert cet onglet. Si spécifié, l'onglet d'ouverture doit être dans la même fenêtre que l'onglet nouvellement créé.openInReaderMode
Facultatifboolean
. sitrue
, ouvrez cet onglet en mode lecture. Par défaut àfalse
.pinned
Facultatifboolean
. Si l'onglet doit être épinglé. Par défaut àfalse
.selected
Facultatifboolean
. Si l'onglet doit devenir l'onglet sélectionné dans la fenêtre. Par défaut àtrue
.Cette propriété est obsolète et n'est pas prise en charge dans Firefox. Utilisezactif
à la place.url
Facultatifstring
. 'URL permettant de naviguer dans l'onglet initialement. Par défaut à la page Nouvel onglet.- Les URL complètes doivent inclure un schéma (i.e. 'http://www.google.com', par 'www.google.com').
- Pour des raisons de sécurité, dans Firefox, il se peut que ce ne soit pas une URL privilégiée. Le passage de l'une des URL suivantes échouera :
-
- chrome: URLs
- javascript: URLs
- data: URLs
- file: URLs (c'est-à-dire, fichiers sur le système de fichiers, cependant, pour utiliser un fichier empaqueté à l'intérieur de l'extension, voir ci-dessous)
- privileged about: URLs (par exemple,
about:config
,about:addons
,about:debugging
) . Les URL non privilégiées (e.g.,about:blank
) sont autorisés. - La page Nouvel onglet (
about:newtab
) peut être ouverte si aucune valeur n'est fournie pour l'URL.
Pour charger une page fournie avec votre extension, spécifiez une URL absolue à partir du fichier manifest.json de l'extension. Par exemple : '/path/to/my-page.html'. Si vous omettez le premier caractère '/', l'URL est traitée comme une URL relative et différents navigateurs peuvent construire différentes URL absolues.
windowId
Facultatifinteger
. La fenêtre pour créer le nouvel onglet. Par défaut à la fenêtre actuelle.
Valeur retournée
A Promise
that will be fulfilled with a tabs.Tab
object containing details about the created tab. If the tab could not be created (for example, because url
used a privileged scheme) the promise will be rejected with an error message.
Exemples
Ouvre "https://example.org" dans un nouvel onglet :
function onCreated(tab) {
console.log(`Created new tab: ${tab.id}`)
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.browserAction.onClicked.addListener(function() {
var creating = browser.tabs.create({
url:"https://example.org"
});
creating.then(onCreated, onError);
});
Example extensions
Compatibilité du navigateur
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Cette API est basée sur l'API Chromium chrome.tabs
. Cette documentation est dérivée de tabs.json
dans le code de Chromium code.
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.