---
title: contextualIdentities
slug: Mozilla/Add-ons/WebExtensions/API/contextualIdentities
tags:
  - Extensões Web
  - Identidade contextual
translation_of: Mozilla/Add-ons/WebExtensions/API/contextualIdentities
---
<div>{{AddonSidebar}}</div>

<p>Trabalhar com identidades contextuais: listar, criar, remover e atualizar identidades contextuais.</p>

<p>"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.</p>

<p>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.</p>

<p><img alt="" src="https://mdn.mozillademos.org/files/14719/containers.png" style="display: block; height: 259px; margin-left: auto; margin-right: auto; width: 515px;">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: <code>privacy.userContext.enabled</code>. 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.</p>

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

<p>Para o Firefox 57 em diante, se uma extensão que usa a API <code>contextualIdentities</code> 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 <code>contextualIdentities</code> rejeitará suas promises com uma mensagem de erro.</p>

<p>Para mais informações sobre identidade contextual no Firefox veja <a href="https://wiki.mozilla.org/Security/Contextual_Identity_Project/Containers">este guia</a>.</p>

<p>Identidades contextuais atualmente não são suportadas em outros navegadores.</p>

<p>Para usar esta API você precisará incluir a <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions">permissão</a> "contextualIdentities" em seu arquivo <a href="https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json">manifest.json</a>.</p>

<h2 id="Tipos">Tipos</h2>

<dl>
 <dt>{{WebExtAPIRef("contextualIdentities.ContextualIdentity")}}</dt>
 <dd>Contém informações sobre uma identidade contextual.</dd>
</dl>

<h2 id="Funções">Funções</h2>

<dl>
 <dt>{{WebExtAPIRef("contextualIdentities.create()")}}</dt>
 <dd>Cria uma nova identidade contextual.</dd>
 <dt>{{WebExtAPIRef("contextualIdentities.get()")}}</dt>
 <dd>Recupera uma única identidade contextual, dado o ID do cookie que armazena.</dd>
 <dt>{{WebExtAPIRef("contextualIdentities.query()")}}</dt>
 <dd>Recupera todas identidades contextuais, ou todas com um nome em particular.</dd>
 <dt>{{WebExtAPIRef("contextualIdentities.update()")}}</dt>
 <dd>Atualiza as propriedades existentes de uma identidade contextual.</dd>
 <dt>{{WebExtAPIRef("contextualIdentities.remove()")}}</dt>
 <dd>Exclui uma identidade contextual.</dd>
 <dt>
 <h2 id="Eventos">Eventos</h2>
 </dt>
 <dt>{{WebExtAPIRef("contextualIdentities.onCreated")}}</dt>
 <dd>Disparado quando uma identidade contextual é criada.</dd>
 <dt>{{WebExtAPIRef("contextualIdentities.onRemoved")}}</dt>
 <dd>Disparado quando uma identidade contextual é removida.</dd>
 <dt>{{WebExtAPIRef("contextualIdentities.onUpdated")}}</dt>
 <dd>Disparado quando uma ou mais propriedades de uma identidade contextual é atualizada.</dd>
</dl>

<h2 id="Compatibilidade_de_navegador">Compatibilidade de navegador</h2>

<p>{{Compat("webextensions.api.contextualIdentities")}} {{WebExtExamples("h2")}}</p>