Trabalhar com identidades contextuais: listar, criar, remover e atualizar identidades contextuais.

"Identidades conceituais", também conhecido como "containers",  consiste em uma funcionalidade do navegador cuja premissa é que usuários assumem multiplas identidades quando navegam na internet, e desejam manter alguma separação entre tais identidades. Por exemplo, um usuário pode considerar sua "identidade de trabalho" separada de sua "identidade pessoal", e não desejar compartilhar cookies entre esses dois contextos.

Com a funcionalidade de identidades contextuais, cada uma possui um nome, cor e um ícone. Novas abas são atribuidas a uma identidade, e o nome, ícone e cor aparecerão na barra de endereço. Internamente, cada identidade guarda seu próprio cookie e não os compartilha entre outras abas.

Identidade contextual é uma funcionalidade experimental no Firefox e está habilitado apenas no Firefox Nightly. Para habilitá-lo em outras versões do Firefox, atribua true as seguintes preferências: privacy.userContext.enabled. Observe que embora identidades contextuais estejam disponíveis no Firefox para Android, não há uma interface gráfica funcionando com ela para esta versão de navegador.

Antes do Firefox 57, a API contextualIdentities é disponível apenas se a funcionalidade de identidade contextual está habilitada por si mesma. Se uma extensão tentou usar a API contextualIdentities API sem a funcionalidade estar habilitada, então as chamadas do método deveria resolver suas promises com false.

Para o Firefox 57 em diante, se uma extensão que usa a API contextualIdentities está instalada, então a funcionalidade de identidade contextual será habilitada automaticamente. Observe que embora ainda é possível para o usuário desabilitar a funcionalidade usando a preferência "privacy.userContext.enabled". Isse isso ocorrer, então a chamada do método contextualIdentities rejeitará suas promises com uma mensagem de erro.

Para mais informações sobre identidade contextual no Firefox veja este guia.

Identidades contextuais atualmente não são suportadas em outros navegadores.

Para usar esta API você precisará incluir a permissão "contextualIdentities" em seu arquivo manifest.json.

Tipos

contextualIdentities.ContextualIdentity
Contém informações sobre uma identidade contextual.

Funções

contextualIdentities.create()
Cria uma nova identidade contextual.
contextualIdentities.get()
Recupera uma única identidade contextual, dado o ID do cookie que armazena.
contextualIdentities.query()
Recupera todas identidades contextuais, ou todas com um nome em particular.
contextualIdentities.update()
Atualiza as propriedades existentes de uma identidade contextual.
contextualIdentities.remove()
Exclui uma identidade contextual.

Eventos

contextualIdentities.onCreated
Disparado quando uma identidade contextual é criada.
contextualIdentities.onRemoved
Disparado quando uma identidade contextual é removida.
contextualIdentities.onUpdated
Disparado quando uma ou mais propriedades de uma identidade contextual é atualizada.

Compatibilidade de navegador

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
createChrome No support NoEdge No support NoFirefox Full support 53
Notes
Full support 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
Opera No support NoFirefox Android Full support 53
Notes
Full support 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
getChrome No support NoEdge No support NoFirefox Full support 53
Notes
Full support 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 No support NoFirefox Android Full support 53
Notes
Full support 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 No support NoEdge No support NoFirefox Full support 57Opera No support NoFirefox Android Full support 57
onRemovedChrome No support NoEdge No support NoFirefox Full support 57Opera No support NoFirefox Android Full support 57
onUpdatedChrome No support NoEdge No support NoFirefox Full support 57Opera No support NoFirefox Android Full support 57
queryChrome No support NoEdge No support NoFirefox Full support 53
Notes
Full support 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
Opera No support NoFirefox Android Full support 53
Notes
Full support 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
removeChrome No support NoEdge No support NoFirefox Full support 53
Notes
Full support 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 No support NoFirefox Android Full support 53
Notes
Full support 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 No support NoEdge No support NoFirefox Full support 53
Notes
Full support 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 No support NoFirefox Android Full support 53
Notes
Full support 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.

Legend

Full support  
Full support
No support  
No support
See implementation notes.
See implementation notes.

Example extensions

Etiquetas do documento e colaboradores

Colaboradores desta página: thiagopelizoni, eduardMariano
Última atualização por: thiagopelizoni,