From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../api/contextualidentities/create/index.html | 108 +++++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 files/fr/mozilla/add-ons/webextensions/api/contextualidentities/create/index.html (limited to 'files/fr/mozilla/add-ons/webextensions/api/contextualidentities/create') diff --git a/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/create/index.html b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/create/index.html new file mode 100644 index 0000000000..de4913c645 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/contextualidentities/create/index.html @@ -0,0 +1,108 @@ +--- +title: contextualIdentities.create() +slug: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/create +tags: + - API + - Add-ons + - Create + - Extensions + - Méthode + - Reference + - WebExtensions + - contextualIdentities +translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities/create +--- +
{{AddonSidebar()}}
+ +

Crée une nouvelle identité contextuelle. Une fois créée, l'utilisateur pourra créer de nouveaux onglets appartenant à cette identité contextuelle, tout comme ils peuvent le faire avec les identités intégrées.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var createContext = browser.contextualIdentities.create(
+  details                  // object
+)
+
+ +

Paramètres

+ +
+
details
+
+

object. Un objet contenant des propriétés pour la nouvelle identité contextuelle. Cela contient les propriétés suivantes :

+ +
+
name
+
+

string. Le nom de la nouvelle identité. Cela sera affiché dans l'interface utilisateur du navigateur, leur permettant d'ouvrir un nouvel onglet appartenant à l'identité. Il sera également affiché dans la barre d'URL pour les onglets appartenant à cette identité.

+
+
color
+
+

string. La couleur associée à la nouvelle identité. Cela sera utilisé pour mettre en évidence les onglets appartenant à cette identité. Vous pouvez fournir l'une des valeurs suivantes ici :

+ +
    +
  • "blue"
    • +
  • "turquoise"
    • +
  • "green"
    • +
  • "yellow"
    • +
  • "orange"
    • +
  • "red"
    • +
  • "pink"
    • +
  • "purple"
    • +
  • "toolbar" 
    • +
+
+
icon
+
+

string. Le nom d'une icône à afficher dans la barre d'URL pour les onglets appartenant à cette identité. Vous pouvez fournir l'une des valeurs suivantes ici :

+ +
    +
  • "fingerprint"
    • +
  • "briefcase"
    • +
  • "dollar"
    • +
  • "cart"
    • +
  • "circle"
    • +
  • "gift"
    • +
  • "vacation"
    • +
  • "food"
    • +
  • "fruit"
    • +
  • "pet"
    • +
  • "tree"
    • +
  • "chill"
    • +
  • "fence"
    • +
+
+
+
+
+ +

Valeur retournée

+ +

Une Promise qui sera remplie avec un {{WebExtAPIRef('contextualIdentities.ContextualIdentity', 'ContextualIdentity')}} qui décrit la nouvelle identité. Si la fonctionnalité d'identités contextuelles n'est pas activée, la promesse est rejetée.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.contextualIdentities.create")}}

+ +

Exemples

+ +

Cet exemple crée une nouvelle identité contextuelle et enregistre son ID de cookie :

+ +
function onCreated(context) {
+  console.log(`New identity's ID: ${context.cookieStoreId}.`);
+}
+
+function onError(e) {
+  console.error(e);
+}
+
+browser.contextualIdentities.create({
+  name: "my-thing",
+  color: "purple",
+  icon: "briefcase"
+}).then(onCreated, onError);
+ +

{{WebExtExamples}}

-- cgit v1.2.3-54-g00ecf