contextualIdentities.update()

Met à jour les propriétés d'une identité contextuelle, compte tenu de son ID de cookie.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var createContext = browser.contextualIdentities.update(
  cookieStoreId,           // string
  details                  // object
)

Paramètres

cookieStoreId

string. L'identifiant du cookie store de cette identité contextuelle. Étant donné que les identités contextuelles ont chacune leur propre magasin de cookies, cela sert d'identifiant pour l'identité contextuelle elle-même.

details

object. Un objet contenant de nouvelles valeurs pour les propriétés que vous souhaitez modifier. Cela peut contenir l'une des propriétés suivantes :

name Facultatif

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

color Facultatif

string. Une nouvelle couleur pour l'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" 
icon Facultatif

string. Une nouvelle icône pour l'identité. Vous pouvez fournir l'une des valeurs suivantes ici :

  • "fingerprint"
  • "briefcase"
  • "dollar"
  • "cart"
  • "circle"

Valeur retournée

Une Promise qui sera remplie avec un ContextualIdentity qui décrit l'identité mise à jour. Si l'identité n'a pas pu être trouvée ou si la fonctionnalité d'identités contextuelles n'est pas activée, la promesse est rejetée.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Aucun support NonEdge Aucun support NonFirefox Support complet 53
Notes
Support complet 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
Notes Before version 57, this method resolves its promise with null if the given identity was not found.
Opera Aucun support NonFirefox Android Support complet 53
Notes
Support complet 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
Notes Before version 57, this method resolves its promise with null if the given identity was not found.

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Exemples

Cet exemple met à jour l'identité contextuelle dont l'ID est "firefox-container-1" pour avoir un nouveau nom, une nouvelle couleur et une nouvelle icône :

function onUpdated(context) {
  console.log(`New identity's name: ${context.name}.`);
}

function onError(e) {
  console.error(e);
}

browser.contextualIdentities.update(
  "firefox-container-1", {
    name: "my-thing",
    color: "purple",
    icon: "briefcase"
  }).then(onUpdated, onError);

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,