Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Object.getOwnPropertyDescriptors — deskriptorji lastnih lastnosti

Pri navadnem objektu Object.getOwnPropertyDescriptors vrne deskriptorje vseh njegovih lastnih lastnosti, tudi lastnosti z atributom `enumerable`, nastavljenim na `false`, in lastnosti s ključi Symbol. Z njim lahko pregledujemo atribute ali kopiramo lastnosti, ne da bi dostopnike pretvorili v vrednosti.

Različica: 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.getOwnPropertyDescriptors(obj)

Object.getOwnPropertyDescriptors(obj) vrne nov navaden objekt. Metoda od obj pridobi seznam ključev lastnih lastnosti in za vsak ključ na seznamu v rezultat vključi ustrezni deskriptor, če ga obj poda. Upošteva lastnosti z nizovnimi ključi in ključi vrste Symbol, tudi tiste z atributom enumerable, nastavljenim na false; podedovane lastnosti so izključene.

Deskriptor podatkovne lastnosti vsebuje value, writable, enumerable in configurable. Deskriptor dostopnika namesto value in writable vsebuje polji get in set; manjkajoča funkcija je predstavljena z undefined. Branje deskriptorjev navadnega objekta ne pokliče njegovih getterjev. Pri objektu Proxy pa se lahko sprožijo pasti in pride do izjem. Rezultat je lahko nepopoln tudi brez izjeme: past ownKeys lahko izpusti ključ nastavljive lastne lastnosti razširljivega ciljnega objekta, tudi če proxy za ta ključ še vedno poda deskriptor lastne lastnosti. Metoda tega deskriptorja potem ne vključi v rezultat.

Pri navadnem objektu vzorec Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) ustvari plitvo kopijo z enakim prototipom in atributi lastnih lastnosti. V nasprotju z Object.assign ohrani dostopnike in lastnosti z atributom enumerable, nastavljenim na false. Ugnezdeni objekti ostanejo v skupni rabi; to ni splošna tehnika za kloniranje objektov, odvisnih od notranjih rež, kot je Map.

null in undefined povzročita TypeError; druge primitivne vrednosti se ovijejo v objekte. Metoda je del ECMAScript 2017, ne Web APIs. Podporo v ciljnem brskalniku je treba preveriti posebej — razpoložljivost v Node 24 tega ne dokazuje.

Primeri

let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
  hidden: { value: 7, enumerable: false },
  doubled: {
    get() { reads += 1; return this.hidden * 2; },
    enumerable: true
  }
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);

Rezultat

0
7 false
function
14 1
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri