contextualIdentities
====================

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.

![](/pt-BR/docs/Mozilla/Add-ons/WebExtensions/API/contextualIdentities/containers.png)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 (en-US).

Tipos
-----

`contextualIdentities.ContextualIdentity` (en-US)

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

Funções
-------

`contextualIdentities.create()` (en-US)

Cria uma nova identidade contextual.

`contextualIdentities.get()` (en-US)

Recupera uma única identidade contextual, dado o ID do cookie que armazena.

`contextualIdentities.query()` (en-US)

Recupera todas identidades contextuais, ou todas com um nome em particular.

`contextualIdentities.update()` (en-US)

Atualiza as propriedades existentes de uma identidade contextual.

`contextualIdentities.remove()` (en-US)

Exclui uma identidade contextual.

Eventos
-------

`contextualIdentities.onCreated` (en-US)

Disparado quando uma identidade contextual é criada.

`contextualIdentities.onRemoved` (en-US)

Disparado quando uma identidade contextual é removida.

`contextualIdentities.onUpdated` (en-US)

Disparado quando uma ou mais propriedades de uma identidade contextual é atualizada.

Compatibilidade com navegadores
-------------------------------

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

Example extensions
------------------

* contextual-identities