CKTIS / JavaScript
Object.getOwnPropertyDescriptor — pregled vlastitog svojstva
Object.getOwnPropertyDescriptor vraća opis vlastitog svojstva objekta: njegovu vrijednost ili pristupnike te oznake njegovih atributa. Ne pretražuje lanac prototipova i vraća undefined ako objekt nema to vlastito svojstvo.
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
Object.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) čita deskriptor jednog vlastitog svojstva, uključujući i neenumerabilno. Ne pretražuje prototipove. Rezultat je novi objekt deskriptora ili undefined ako se svojstvo ne nalazi izravno u obj. Postojeće svojstvo čija je vrijednost undefined i dalje ima deskriptor.
Deskriptor podatkovnog svojstva sadrži value, writable, enumerable i configurable. Deskriptor pristupnog svojstva umjesto value i writable sadrži get i set; pristupnik koji nedostaje ima vrijednost undefined. Kod običnog objekta čitanje deskriptora ne poziva getter. writable određuje može li dodjela promijeniti vrijednost, enumerable uključuje li se svojstvo u enumeraciju, a configurable može li se svojstvo izbrisati ili ponovno konfigurirati.
Promjena polja vraćenog objekta ne mijenja izvorno svojstvo. Za primjenu deskriptora upotrijebite Object.defineProperty, uzimajući u obzir ograničenja postojećeg svojstva. Deskriptor nije duboka kopija: objekt pohranjen u value ostaje ista referenca.
key se pretvara u ključ svojstva: niz ili simbol. Prosljeđivanje null ili undefined kao obj uzrokuje TypeError; ostale primitivne vrijednosti omataju se u objekte. Kod Proxy objekta operacija može pozvati zamku getOwnPropertyDescriptor, pa može imati nuspojave ili izbaciti iznimku.
Primjeri
const obj = Object.create({ inherited: 1 });
Object.defineProperty(obj, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Object.getOwnPropertyDescriptor(obj, "score");
console.log(descriptor.value, descriptor.writable);
console.log(descriptor.enumerable, descriptor.configurable);
descriptor.value = 99;
console.log(obj.score);
console.log(Object.getOwnPropertyDescriptor(obj, "inherited"));Rezultat
42 false true true 42 undefined
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.