Travailler avec des identités contextuelles: lister, créer, supprimer et mettre à jour des identités contextuelles.

Les "identités contextuelles", également appelées "conteneurs", sont des fonctions de navigation qui répondent à l'idée que les utilisateurs assument plusieurs identités lorsqu'ils naviguent sur le web, et souhaitent maintenir une certaine séparation entre ces identités. Par exemple, un utilisateur peut considérer que son "identité de travail" est distincte de son "identité personnelle" et ne veut pas partager les cookies entre ces deux contextes.

Avec la fonctionnalité d'identités contextuelles, chaque identité contextuelle a un nom, une couleur et une icône. De nouveaux onglets peuvent être assignés à une identité et le nom, l'icône et la couleur apparaîtront dans la barre d'adresse. En interne, chaque identité possède son propre magasin de cookies qui n'est pas partagé avec d'autres onglets....

Les identités contextuelles sont une fonctionnalité expérimentale de Firefox et ne sont activées par défaut dans Firefox Nightly. Pour activer dans d'autres versions de Firefox, définissez la préférence  privacy.userContext.enabled sur true. Notez que bien que les identités contextuelles soient disponibles dans Firefox pour Android, il n'y a pas d'interface utilisateur pour travailler avec eux dans cette version pour travailler avec eux dans cette versiondu navigateur.

Avant Firefox 57, l'API contextualIdentities n'est disponible que si la fonctionnalité d'identitées contextuelles est elle-même activée. Si une extension essayait d'utiliser l'API contextualIdentities sans activer la fonctionnalité, les appels de méthode résoudraient leurs promesses avec  false.

A partir de Firefox 57, si une extension utilisant l'API  contextualIdentities est installée, la fonctionnalité d'identités contextuelles sera automatiquement activée. Notez cependant qu'il est toujours possible pour l'utilisateur de désactiver la fonctionnalité en utilisant la préférence "privacy.userContext.enabled". Si cela se produit, les appels de méthode contextualIdentities rejetteront leurs promesses avec un message d'erreur.

Pour plus d'informations sur les identités contextuelles, consultez  ce guide.

Les identités contextuelles ne sont actuellement pas supportes dans les autres navigateurs.

Pour utiliser cette API, vous devez inclure la  permission "contextualIdentities" dans votre fichier manifest.json.

Types

contextualIdentities.ContextualIdentity
Contient des informations sur une identité contextuelle.

Fonctions

contextualIdentities.create()
Crée une nouvelle identité contextuelle.
contextualIdentities.get()
Récupère une identité contextuelle unique, compte tenu de son ID de cookie.
contextualIdentities.query()
Récupère toutes les identités contextuelles ou toutes les identités contextuelles avec un nom particulier.
contextualIdentities.update()
Met à jour les propriétés d'une identité contextuelle existante.
contextualIdentities.remove()
Supprime une identité contextuelle.

Evénements

contextualIdentities.onCreated
Lancé lorsqu'une identité contextuelle est créée
contextualIdentities.onRemoved
Lancé lorsqu'une identité contextuelle est supprimée
contextualIdentities.onUpdated
Lancé lorsqu'une ou plusieurs propriétés d'une identité contextuelle sont mises à jour

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
createChrome 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.
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.
getChrome 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.
onCreatedChrome Aucun support NonEdge Aucun support NonFirefox Support complet 57Opera Aucun support NonFirefox Android Support complet 57
onRemovedChrome Aucun support NonEdge Aucun support NonFirefox Support complet 57Opera Aucun support NonFirefox Android Support complet 57
onUpdatedChrome Aucun support NonEdge Aucun support NonFirefox Support complet 57Opera Aucun support NonFirefox Android Support complet 57
queryChrome 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.
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.
removeChrome 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.
updateChrome 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.

Example extensions

Étiquettes et contributeurs liés au document

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