Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje