Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Object.defineProperty: natančen deskriptor lastnosti

Object.defineProperty določi ali spremeni eno lastno lastnost z izrecnim podatkovnim ali dostopnim deskriptorjem.

Različica: ECMAScript 5 onward; example target: Node.js 24.22.2

Sintaksa

Object.defineProperty(obj, key, descriptor)

Object.defineProperty(obj, key, descriptor) zahteva dejanski objekt kot obj; primitivnih vrednosti ne ovija. key gre skozi ToPropertyKey in postane niz ali simbol. descriptor se prebere z ToPropertyDescriptor, metoda pa vrne isti ciljni objekt.

Podatkovni deskriptor uporablja value in writable, dostopni pa get in set; mešanje polj obeh vrst sproži TypeError. Pri ustvarjanju nove lastnosti so manjkajoči writable, enumerable in configurable false, manjkajoči value, get in set pa pomenijo undefined; pri spreminjanju obstoječe lastnosti izpuščena polja pustijo njene trenutne atribute nespremenjene. Getter ali setter mora biti klicljiv ali undefined.

Metoda obstaja od ECMAScript 5. DefinePropertyOrThrow sproži TypeError pri dodajanju nove lastnosti nerazširljivemu objektu, če sprememba krši pravila nekonfigurabilne lastnosti ali Proxy prekrši invariante. Združljiva ponovna določitev obstoječe lastnosti lahko uspe tudi na nerazširljivem objektu. Za razliko od prirejanja nadzira atribute brez klica podedovanega setterja, vendar lahko branje deskriptorja in pasti Proxy izvajajo kodo in sprožijo izjemo.

Primeri

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); }

Rezultat

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

Primer določi podatkovno lastnost in getter, pregleda atribute ter preizkusi dva TypeError.

Viri