Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori