Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Reflect.ownKeys — všechny vlastní klíče objektu

Reflect.ownKeys(target) vyžaduje jako argument objekt. Pro běžný objekt vrací pole všech vlastních klíčů: řetězců i symbolů, včetně klíčů neenumerovatelných vlastností. Zděděné vlastnosti vynechává. Past ownKeys objektu Proxy může změnit, které klíče se vrátí.

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

Syntaxe

Reflect.ownKeys(target)

Reflect.ownKeys(target) vytvoří nové pole klíčů. Je-li target běžný objekt, pole obsahuje klíče všech jeho vlastních vlastností, enumerovatelných i neenumerovatelných. Jeho prvky jsou řetězce nebo symboly, nikoli hodnoty vlastností. Řetězec prototypů neprohledává. Argument, který není objektem, včetně null nebo řetězce, způsobí TypeError; automaticky se nepřevádí na objekt.

U běžných objektů jsou nejprve klíče, které jsou indexy pole, ve vzestupném číselném pořadí. Následují ostatní řetězce v pořadí vytvoření vlastností a nakonec symboly v pořadí vytvoření příslušných vlastností. Proto je "2" před "10", i když byly přidány v opačném pořadí; samotné klíče jsou stále řetězce.

Naproti tomu Object.keys vrací pouze enumerovatelné řetězcové klíče. Object.getOwnPropertyNames zahrnuje vlastní řetězcové klíče, zatímco Object.getOwnPropertySymbols zahrnuje vlastní symboly. Reflect.ownKeys použijte, když potřebujete oba druhy klíčů bez filtrování podle enumerovatelnosti.

Metoda vyvolá interní operaci [[OwnPropertyKeys]]. U objektu Proxy tím může spustit past ownKeys, takže se může vykonat uživatelský kód, může být vyvolána výjimka nebo se mohou klíče vrátit v jiném povoleném pořadí než u běžného objektu. Past může změnit i množinu klíčů: pokud je cílový objekt proxy rozšiřitelný, může vynechat klíče konfigurovatelných vlastních vlastností nebo vrátit navíc klíče, pro které cílový objekt nemá deskriptor vlastní vlastnosti. Klíče nekonfigurovatelných vlastních vlastností musí zahrnout. Pokud cílový objekt není rozšiřitelný, musí vrácená množina přesně odpovídat množině jeho vlastních klíčů. Nepředpokládejte, že každý exotický objekt používá běžné pořadí. Jde o API jazyka ECMAScript; samotná přítomnost Node 24 v repozitáři nedokládá podporu v cílovém prohlížeči.

Pří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ýsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje