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
42Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.