CKTIS / JavaScript
Object.prototype, descritores de propriedades e acessores
Distingue onde se encontra uma propriedade na cadeia de protótipos de como funciona: pode guardar um valor ou usar um getter ou um setter.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
Object.prototype
Object.getPrototypeOf(obj)
Object.hasOwn(obj, key)
Object.getOwnPropertyDescriptor(obj, key)
Object.defineProperty(obj, key, { value: 1, writable: true, enumerable: true, configurable: true })
Object.defineProperty(obj, key, { get() { return this._value; }, set(value) { this._value = value; }, configurable: true })Object.prototype é o objeto partilhado no fim de muitas cadeias de protótipos, incluindo a de {}. O seu próprio protótipo é null. Um objeto criado com Object.create(null) não herda dele. Para consultar o protótipo imediato, usa Object.getPrototypeOf(obj) em vez do antigo acessor __proto__, que pode estar ausente ou oculto. Evita adicionar propriedades da aplicação a Object.prototype: outros objetos podem herdá-las.
Um descritor descreve os atributos de uma propriedade. Uma propriedade de dados guarda um value, e writable determina se uma atribuição pode alterá-lo. Uma propriedade acessora tem, em vez disso, get e set, cada um dos quais é uma função ou undefined. Ambos os tipos têm enumerable (que influencia, por exemplo, se uma chave própria do tipo cadeia de caracteres aparece em Object.keys) e configurable (que controla a eliminação e restringe alterações aos atributos). Um acessor é um tipo de propriedade, não uma alternativa a um descritor.
Nos objetos ordinários, a leitura procura primeiro nas propriedades próprias e depois na cadeia de protótipos. Uma propriedade de dados devolve o valor guardado; ao ler obj.key através de um getter, este é chamado com o objeto original como this. Sem getter, a leitura devolve undefined. Atribuir um valor a uma propriedade acessora herdada chama o setter com o mesmo this; atribuir um valor a uma propriedade de dados herdada e gravável cria uma propriedade própria se o objeto for extensível. Sem setter ou com writable: false, a atribuição é bloqueada: lança TypeError em modo estrito e deixa a propriedade inalterada nos restantes casos.
Object.hasOwn(obj, key) verifica apenas as propriedades próprias; key in obj também considera as herdadas. Object.getOwnPropertyDescriptor(obj, key) devolve um objeto separado que descreve uma propriedade própria, ou undefined se não existir. Num objeto ordinário não chama o getter da propriedade inspecionada. Alterar os campos do descritor devolvido não altera a propriedade.
Object.defineProperty(obj, key, descriptor) define ou atualiza uma propriedade própria sem chamar um setter herdado. Numa propriedade nova, os indicadores omitidos writable (para dados), enumerable e configurable assumem false; numa atualização sem mudança de tipo, os atributos omitidos mantêm os valores. Combinar value ou writable com get ou set, ou tentar uma redefinição não permitida, lança TypeError mesmo fora do modo estrito.
Exemplos
(() => {
'use strict';
const proto = {
points: 2,
get score() { return this.points * 2; },
set score(value) { this.points = value / 2; }
};
const player = Object.create(proto);
const accessor = Object.getOwnPropertyDescriptor(proto, 'score');
console.log(`${'score' in player} ${Object.hasOwn(player, 'score')} ${typeof accessor.get}`);
player.score = 12;
console.log(`${player.score} ${player.points} ${proto.points}`);
Object.defineProperty(player, 'score', { value: 99 });
const data = Object.getOwnPropertyDescriptor(player, 'score');
console.log(`${player.score} ${player.points} ${data.writable} ${data.enumerable} ${data.configurable}`);
})();Resultado
true false function 12 6 2 99 6 false false false
O setter de `score` escreve na propriedade própria `player.points` sem alterar `proto.points`. Depois, `Object.defineProperty` oculta o acessor com uma propriedade de dados própria sem chamar o setter.
Lições relacionadas
- JavaScript · Lição 17 · Avançado · Versão: 4