Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Reflect.ownKeys — všetky vlastné kľúče objektu

Reflect.ownKeys(target) vyžaduje ako argument objekt. Pre bežný objekt vracia pole všetkých vlastných kľúčov: reťazcov aj symbolov, vrátane kľúčov neenumerovateľných vlastností. Zdedené vlastnosti vynecháva. Pasca ownKeys objektu Proxy môže zmeniť, ktoré kľúče sa vrátia.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Reflect.ownKeys(target)

Reflect.ownKeys(target) vytvorí nové pole kľúčov. Ak je target bežný objekt, pole obsahuje kľúče všetkých jeho vlastných vlastností, enumerovateľných aj neenumerovateľných. Jeho prvkami sú reťazce alebo symboly, nie hodnoty vlastností. Reťazec prototypov neprehľadáva. Argument, ktorý nie je objektom, vrátane null alebo reťazca, spôsobí TypeError; automaticky sa neprevedie na objekt.

Pri bežných objektoch sú najprv kľúče, ktoré sú indexmi poľa, vo vzostupnom číselnom poradí. Potom nasledujú ostatné reťazce v poradí vytvorenia vlastností a napokon symboly v poradí vytvorenia príslušných vlastností. Preto je "2" pred "10", aj keď boli pridané v opačnom poradí; samotné kľúče sú stále reťazce.

Na rozdiel od toho Object.keys vracia iba enumerovateľné reťazcové kľúče. Object.getOwnPropertyNames zahŕňa vlastné reťazcové kľúče, kým Object.getOwnPropertySymbols zahŕňa vlastné symboly. Reflect.ownKeys použite, keď potrebujete oba druhy kľúčov bez filtrovania podľa enumerovateľnosti.

Metóda vyvolá internú operáciu [[OwnPropertyKeys]]. Pri objekte Proxy môže tým spustiť pascu ownKeys, takže môže vykonať používateľský kód, vyvolať výnimku alebo vrátiť kľúče v inom povolenom poradí než pri bežnom objekte. Pasca môže zmeniť aj množinu kľúčov: ak je cieľový objekt proxy rozšíriteľný, môže vynechať kľúče konfigurovateľných vlastných vlastností alebo vrátiť navyše kľúče, pre ktoré cieľový objekt nemá deskriptor vlastnej vlastnosti. Kľúče nekonfigurovateľných vlastných vlastností musí zahrnúť. Ak cieľový objekt nie je rozšíriteľný, vrátená množina sa musí presne zhodovať s množinou jeho vlastných kľúčov. Nepredpokladajte, že každý exotický objekt používa bežné poradie. Ide o API jazyka ECMAScript; samotná prítomnosť Node 24 v repozitári nedokazuje podporu v cieľovom prehliadači.

Príklady

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);

Výsledok

2 | 10 | name | hidden | Symbol(tag)
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje