CKTIS / JavaScript
Reflect.ownKeys — svi vlastiti ključevi objekta
Reflect.ownKeys(target) kao argument zahtijeva objekt. Za običan objekt vraća polje svih vlastitih ključeva: nizova i simbola, uključujući ključeve neenumerabilnih svojstava. Naslijeđena svojstva izostavlja. Zamka ownKeys objekta Proxy može promijeniti koji se ključevi vraćaju.
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.ownKeys(target)Reflect.ownKeys(target) stvara novo polje ključeva. Ako je target običan objekt, polje sadrži ključeve svih njegovih vlastitih svojstava, i enumerabilnih i neenumerabilnih. Elementi su nizovi ili simboli, a ne vrijednosti svojstava. Ne pretražuje lanac prototipova. Argument koji nije objekt, uključujući null ili niz, uzrokuje TypeError; ne pretvara se automatski u objekt.
Kod običnih objekata najprije dolaze ključevi koji su indeksi polja, uzlaznim brojčanim redoslijedom. Zatim slijede ostali nizovi redoslijedom stvaranja svojstava, a na kraju simboli redoslijedom stvaranja pripadajućih svojstava. Zato je "2" prije "10" čak i ako su dodani obrnutim redoslijedom; sami ključevi i dalje su nizovi.
Nasuprot tome, Object.keys vraća samo enumerabilne ključeve vrste niz. Object.getOwnPropertyNames obuhvaća vlastite ključeve vrste niz, dok Object.getOwnPropertySymbols obuhvaća vlastite simbole. Upotrijebi Reflect.ownKeys kada su ti potrebne obje vrste ključeva bez filtriranja prema enumerabilnosti.
Metoda poziva internu operaciju [[OwnPropertyKeys]]. Kod objekta Proxy to može aktivirati zamku ownKeys, pa se može izvršiti korisnički kod, izazvati iznimka ili vratiti ključeve drukčijim dopuštenim redoslijedom nego kod običnog objekta. Zamka može promijeniti i skup vraćenih ključeva: ako je ciljni objekt proxyja proširiv, može izostaviti ključeve konfigurabilnih vlastitih svojstava ili vratiti dodatne ključeve za koje ciljni objekt nema deskriptor vlastitog svojstva. Mora uključiti ključeve nekonfigurabilnih vlastitih svojstava. Ako ciljni objekt nije proširiv, vraćeni skup mora se točno podudarati sa skupom njegovih vlastitih ključeva. Nemoj pretpostaviti da svaki egzotični objekt koristi uobičajeni redoslijed. Ovo je API jezika ECMAScript; sama prisutnost Node 24 u repozitoriju ne dokazuje podršku u ciljnom pregledniku.
Primjeri
const tag = Symbol("tag");
const target = Object.create({ inherited: true });
target["10"] = "ten";
target["2"] = "two";
target.name = "Ada";
Object.defineProperty(target, "hidden", { value: 42 });
target[tag] = "metadata";
const keys = Reflect.ownKeys(target);
console.log(keys.map(key => String(key)).join(" | "));
console.log(keys[keys.length - 1] === tag);Rezultat
2 | 10 | name | hidden | Symbol(tag) true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.