Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Object.defineProperty: presný deskriptor vlastnosti

Object.defineProperty definuje alebo zmení jednu vlastnú vlastnosť pomocou explicitného dátového či prístupového deskriptora.

Verzia: ECMAScript 5 onward; example target: Node.js 24.22.2

Syntax

Object.defineProperty(obj, key, descriptor)

Object.defineProperty(obj, key, descriptor) vyžaduje skutočný objekt ako obj; primitívne hodnoty nebaľuje. key prejde ToPropertyKey, takže sa stane reťazcom alebo symbolom. descriptor sa načíta cez ToPropertyDescriptor a metóda vráti rovnaký cieľový objekt.

Dátový deskriptor používa value a writable, prístupový deskriptor get a set; kombinácia polí oboch druhov vyvolá TypeError. Pri vytvorení novej vlastnosti sú chýbajúce writable, enumerable a configurable false a chýbajúce value, get a set znamenajú undefined; pri zmene existujúcej vlastnosti ponechajú vynechané polia jej súčasné atribúty bez zmeny. Getter a setter musia byť volateľné alebo undefined.

Metóda existuje od ECMAScript 5. DefinePropertyOrThrow vyvolá TypeError pri pridaní novej vlastnosti do nerozšíriteľného objektu, keď zmena poruší pravidlá nekonfigurovateľnej vlastnosti alebo Proxy poruší invarianty. Kompatibilné predefinovanie existujúcej vlastnosti môže uspieť aj na nerozšíriteľnom objekte. Na rozdiel od priradenia riadi atribúty bez vyvolania zdedeného setteru, no čítanie deskriptora a pasce Proxy môžu spustiť kód a vyvolať výnimku.

Prí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ýsledok

true balance
10 #1 #2
false false undefined
TypeError 10
TypeError

Príklad definuje dátovú vlastnosť a getter, skontroluje atribúty a vyvolá dva prípady TypeError.

Zdroje