CKTIS / JavaScript
Object.defineProperty: přesný deskriptor vlastnosti
Object.defineProperty definuje nebo změní jednu vlastní vlastnost pomocí explicitního datového či přístupového deskriptoru.
Verze: ECMAScript 5 onward; example target: Node.js 24.22.2
Syntaxe
Object.defineProperty(obj, key, descriptor)Object.defineProperty(obj, key, descriptor) vyžaduje skutečný objekt jako obj; primitivní hodnoty nebalí. key projde ToPropertyKey, takže se stane řetězcem nebo symbolem. descriptor se načte přes ToPropertyDescriptor a metoda vrátí stejný cílový objekt.
Datový deskriptor používá value a writable, přístupový deskriptor get a set; kombinace polí obou druhů vyvolá TypeError. Při vytvoření nové vlastnosti jsou chybějící writable, enumerable a configurable false a chybějící value, get a set znamenají undefined; při změně existující vlastnosti ponechají vynechaná pole její současné atributy beze změny. Getter a setter musí být volatelný nebo undefined.
Metoda existuje od ECMAScript 5. DefinePropertyOrThrow vyvolá TypeError při přidání nové vlastnosti do nerozšiřitelného objektu, když změna poruší pravidla nekonfigurovatelné vlastnosti nebo Proxy poruší invarianty. Kompatibilní předefinování existující vlastnosti může uspět i na nerozšiřitelném objektu. Na rozdíl od přiřazení řídí atributy bez vyvolání zděděného setteru, avšak čtení deskriptoru a pasti Proxy mohou spustit kód a vyvolat výjimku.
Příklady
const account = {};
const same = Object.defineProperty(account, "balance", {
value: 10, writable: false, enumerable: true, configurable: false
});
let reads = 0;
Object.defineProperty(account, "label", {
get() { return `#${++reads}`; }, configurable: true
});
console.log(same === account, Object.keys(account).join(","));
console.log(account.balance, account.label, account.label);
const balance = Object.getOwnPropertyDescriptor(account, "balance");
const label = Object.getOwnPropertyDescriptor(account, "label");
console.log(balance.writable, balance.configurable, label.set);
try { Object.defineProperty(account, "balance", { value: 11 }); }
catch (error) { console.log(error.name, account.balance); }
try { Object.defineProperty({}, "x", { value: 1, get() {} }); }
catch (error) { console.log(error.name); }Výsledek
true balance 10 #1 #2 false false undefined TypeError 10 TypeError
Příklad definuje datovou vlastnost a getter, zkontroluje atributy a vyvolá dva případy TypeError.