Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Reflect.defineProperty — definiranje svojstava s logičkim rezultatom

Reflect.defineProperty definira ili mijenja vlastito svojstvo objekta pomoću deskriptora. Vraća true ili false, ali ne jamči izvođenje bez iznimaka.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

Reflect.defineProperty(target, propertyKey, attributes)

Reflect.defineProperty(target, propertyKey, attributes) definira ili mijenja vlastito svojstvo objekta target. Ključ se pretvara u niz ili simbol, a attributes je objekt deskriptora. Metoda vraća true ako operacija uspije ili false ako je pravila objekta odbiju.

Podatkovni deskriptor koristi value i writable, a deskriptor pristupnika koristi get i set. Oba mogu sadržavati enumerable i configurable. Podatkovna polja ne smiju se kombinirati s poljima pristupnika. Pri stvaranju svojstva na običnom objektu izostavljene zastavice imaju zadanu vrijednost false, a izostavljena podatkovna vrijednost ima zadanu vrijednost undefined. Na običnom objektu izostavljena polja ostaju nepromijenjena ako se pri izmjeni postojećeg svojstva ne mijenja njegova vrsta. Konfigurabilno svojstvo može se pretvoriti iz podatkovnog svojstva u svojstvo s pristupnicima ili obratno. Ako se pri pretvorbi izostave enumerable i configurable, zadržavaju prethodne vrijednosti. Na primjer, ako se konfigurabilno podatkovno svojstvo pretvori u svojstvo s pristupnicima navođenjem samo polja get, polja value i writable uklanjaju se, a izostavljeno polje set dobiva vrijednost undefined.

Zamka defineProperty objekta Proxy prima objekt deskriptora u kojem izostavljena polja i dalje nedostaju. Na ciljnom objektu može stvoriti svojstvo s drukčijim atributima, pod uvjetom da ne prekrši invarijante objekta Proxy.

Za razliku od Object.defineProperty, koja vraća objekt i izbacuje TypeError kada se definicija odbije, ova metoda vraća logički rezultat. Ipak, nije bez iznimaka: poziv mogu prekinuti target koji nije objekt, nevaljan deskriptor ili iznimka tijekom pretvorbe ključa. I zamka defineProperty objekta Proxy može izbaciti iznimku.

Za običan objekt dodavanje svojstva neproširivom objektu ili nedopuštena izmjena nekonfigurabilnog svojstva vraća false. U primjeru druga definicija ne može promijeniti id jer su writable i configurable postavljeni na false; vrijednost ostaje 7.

Primjeri

const item = {};

console.log(Reflect.defineProperty(item, "id", {
  value: 7,
  enumerable: true,
  writable: false,
  configurable: false
}));
console.log(Reflect.defineProperty(item, "id", { value: 8 }));
console.log(item.id);
console.log(Object.keys(item).join(","));

Rezultat

true
false
7
id

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori