CKTIS / JavaScript
Reflect.ownKeys — vsi lastni ključi objekta
Reflect.ownKeys(target) kot argument zahteva objekt. Za običajen objekt vrne polje vseh lastnih ključev: nizov in simbolov, tudi ključev neenumerabilnih lastnosti. Podedovane lastnosti izpusti. Past ownKeys objekta Proxy lahko spremeni, kateri ključi se vrnejo.
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
Reflect.ownKeys(target)Reflect.ownKeys(target) ustvari novo polje ključev. Če je target običajen objekt, polje vsebuje ključe vseh njegovih lastnih lastnosti, tako enumerabilnih kot neenumerabilnih. Njegovi elementi so nizi ali simboli, ne vrednosti lastnosti. Verige prototipov ne preiskuje. Argument, ki ni objekt, vključno z null ali nizom, povzroči TypeError; samodejno se ne pretvori v objekt.
Pri običajnih objektih so najprej ključi, ki so indeksi polja, v naraščajočem številskem vrstnem redu. Nato sledijo drugi nizi po vrstnem redu nastanka lastnosti, nazadnje pa simboli po vrstnem redu nastanka pripadajočih lastnosti. Zato je "2" pred "10", tudi če sta bila dodana v obratnem vrstnem redu; ključi sami so še vedno nizi.
Object.keys v nasprotju s tem vrne samo enumerabilne ključe tipa niz. Object.getOwnPropertyNames vključuje lastne ključe tipa niz, Object.getOwnPropertySymbols pa lastne simbole. Reflect.ownKeys uporabi, kadar potrebuješ obe vrsti ključev brez filtriranja glede na enumerabilnost.
Metoda pokliče notranjo operacijo [[OwnPropertyKeys]]. Pri objektu Proxy lahko to sproži past ownKeys, zato se lahko izvede uporabniška koda, sproži izjema ali se ključi vrnejo v drugačnem dovoljenem vrstnem redu kot pri običajnem objektu. Past lahko spremeni tudi nabor ključev: če je ciljni objekt proxyja razširljiv, lahko izpusti ključe nastavljivih lastnih lastnosti ali vrne dodatne ključe, za katere ciljni objekt nima deskriptorja lastne lastnosti. Vključiti mora ključe nenastavljivih lastnih lastnosti. Če ciljni objekt ni razširljiv, se mora vrnjeni nabor natančno ujemati z naborom njegovih lastnih ključev. Ne predpostavljaj, da ima vsak eksotični objekt običajen vrstni red. To je API jezika ECMAScript; sama prisotnost Node 24 v repozitoriju ne dokazuje podpore v ciljnem brskalniku.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.