1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
---
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="Browser_compatibility">Compatibilidade com navegadores</h2>
<p>{{Compat("webextensions.api.contextualIdentities")}} {{WebExtExamples("h2")}}</p>
|
