Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Reflect.getOwnPropertyDescriptor — pregled vlastitog svojstva

Reflect.getOwnPropertyDescriptor(target, key) vraća deskriptor vlastitog svojstva ili undefined. Omogućuje pregled vrijednosti, pristupnika i atributa svojstva bez pretraživanja lanca prototipova.

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.getOwnPropertyDescriptor(target, key)

Reflect.getOwnPropertyDescriptor(target, key) opisuje samo vlastito svojstvo objekta target, uključujući i ono koje nije enumerabilno. Vraća novi objekt deskriptora ili undefined ako svojstvo nije vlastito. Naslijeđeno svojstvo ne traži se u lancu prototipova; i vlastito svojstvo čija je vrijednost undefined i dalje ima deskriptor.

Podatkovni deskriptor sadrži value, writable, enumerable i configurable. Deskriptor pristupnika umjesto value i writable sadrži polja get i set; njihove su vrijednosti funkcije ili undefined. Pregled deskriptora običnog objekta ne poziva njegov getter. Promjena vraćenog deskriptora sama po sebi ne redefinira svojstvo; za to se može upotrijebiti, primjerice, Object.defineProperty.

target mora biti objekt; svaka primitivna vrijednost, uključujući null i undefined, uzrokuje TypeError. To se razlikuje od Object.getOwnPropertyDescriptor, koji omata primitivne vrijednosti osim null i undefined. Operacija ToPropertyKey pretvara key u ključ svojstva. Ako je key objekt, operacija ga najprije pretvara u primitivnu vrijednost, primjerice pozivom njegove metode Symbol.toPrimitive. Ako je primitivna vrijednost simbol, zadržava se kao ključ; u suprotnom se pretvara u niz znakova.

Nemojte pretpostaviti da je operacija uvijek bez nuspojava: pretvorba key može pokrenuti korisnički kod, a objekt Proxy može aktivirati svoju zamku getOwnPropertyDescriptor. Nastale iznimke prosljeđuju se pozivatelju. Primjer pokazuje da se naslijeđeno svojstvo zanemaruje i da promjena descriptor.value ne mijenja item.score.

Primjeri

const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
  value: 42,
  writable: false,
  enumerable: true,
  configurable: true
});

const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);

Rezultat

{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42

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

Izvori