tabs.create()
=============

Crée un nouvel onglet

C'est une fonction asynchrone qui renvoie une `Promise`.

Syntaxe
-------


```js
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 documentation `tabs.Tab`.

`active`Facultatif

`boolean`. Si l'onglet doit devenir l'onglet actif dans la fenêtre. Si elle est `false`, elle n'a aucun effet. N'affecte pas si la fenêtre est mise au point (voir `windows.update`). Par défaut à `true`.

`cookieStoreId` Facultatif

`string`. 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`Facultatif

`integer`. 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`Facultatif

`integer`. 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`Facultatif

`boolean`. si `true`, ouvrez cet onglet en mode lecture. Par défaut à `false`.

`pinned`Facultatif

`boolean`. Si l'onglet doit être épinglé. Par défaut à `false`.

`selected`Facultatif

`boolean`. Si l'onglet doit devenir l'onglet sélectionné dans la fenêtre. Par défaut à `true`.

**Attention :** Cette propriété est obsolète et n'est pas prise en charge dans Firefox. Utilisez `actif` à la place.

`url`Facultatif

`string`. '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`Facultatif

`integer`. 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 :


```js
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

* commands
* contextual-identities
* find-across-tabs
* firefox-code-search
* open-my-page-button
* permissions
* store-collected-images
* tabs-tabs-tabs
Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

**Note :**

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.