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.