Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Symbol — valores únicos e chaves de propriedades

Symbol() cria um valor primitivo único e imutável que pode servir de chave de propriedade de um objeto. A descrição não determina a identidade do símbolo; Symbol.for() permite, em alternativa, partilhar um símbolo através de um registo.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

Symbol()
Symbol(description)
Symbol.for(key)
Symbol.keyFor(symbol)

Symbol(description) devolve um novo valor primitivo único do tipo symbol, não um objeto. A descrição opcional ajuda a identificar o símbolo, mas não é a sua identidade: duas chamadas a Symbol("id") produzem valores diferentes. new Symbol() lança um TypeError.

Um símbolo pode ser uma chave de propriedade independente das chaves de texto. { [first]: "internal" } cria uma propriedade cuja chave é o valor guardado em first, e record[first] lê o respetivo valor. A propriedade record.id tem uma chave diferente e pode coexistir com ela sem conflito.

Symbol.for(key) procura ou cria um símbolo no registo global: a mesma chave de texto devolve o mesmo símbolo. Symbol.keyFor(symbol) devolve a chave do registo, ou undefined se o símbolo não estiver registado. Este comportamento é diferente de criar um novo símbolo com Symbol().

Uma chave de símbolo não garante privacidade: pode ser encontrada através de Object.getOwnPropertySymbols(), embora Object.keys() a omita. Os símbolos integrados, como Symbol.iterator, constituem um grupo separado de chaves predefinidas usadas pelos protocolos da linguagem.

Exemplos

const first = Symbol("id");
const second = Symbol("id");
const record = { id: "public", [first]: "internal" };

console.log(typeof first);
console.log(first === second);
console.log(record.id);
console.log(record[first]);
console.log(Symbol.for("app.id") === Symbol.for("app.id"));
console.log(Symbol.keyFor(Symbol.for("app.id")));

Resultado

symbol
false
public
internal
true
app.id

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes