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

CKTIS / JavaScript

Object.keys — vlastní výčítatelné klíče objektu

Object.keys(obj) vrací nové pole vlastních výčitatelných řetězcových klíčů objektu. Vylučuje zděděné a nevýčitatelné vlastnosti i klíče Symbol. U běžných objektů se klíče, které jsou indexy pole, řadí před ostatní řetězcové klíče.

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

Object.keys(obj)

Object.keys(obj) je statická metoda objektu Object, která vrací nové pole názvů vlastností. Zahrnuje pouze vlastní vlastnosti, tedy ty, které nejsou zděděné z prototypu, jejichž atribut enumerable má hodnotu true a jejichž klíčem je řetězec. Výsledek obsahuje řetězce, i když byly klíče zapsány jako čísla. Klíče Symbol jsou vyloučeny.

U běžných objektů se klíče, které jsou indexy pole, řadí vzestupně podle číselné hodnoty; po nich následují ostatní řetězcové klíče v pořadí vytvoření vlastností. Nejde o abecední řazení ani o pravidlo pro každý řetězec připomínající číslo: "02" není index pole. Objekty Proxy mohou pořadí ovlivnit a během výčtu spouštět kód.

Na rozdíl od for...in metoda nezahrnuje zděděné výčitatelné vlastnosti. Reflect.ownKeys(obj) naopak zahrnuje také vlastní nevýčitatelné vlastnosti a klíče Symbol. Samotné Object.keys nečte hodnoty vlastností ani nevolá jejich gettery; vrácené pole se při změně objektu neaktualizuje.

null a undefined způsobí TypeError. Ostatní primitivní hodnoty se převedou na objekty: Object.keys("ab") vrátí ["0","1"], zatímco Object.keys(42) vrátí []. Jde o API jazyka ECMAScript, nikoli o API prohlížeče; spuštění příkladu v Node.js nedokazuje kompatibilitu s konkrétním prohlížečem.

Příklady

const item = Object.create({ inherited: true });
item.name = "Ada";
item[10] = "ten";
item[2] = "two";
Object.defineProperty(item, "hidden", { value: true });
item[Symbol("tag")] = true;

console.log(JSON.stringify(Object.keys(item)));

Výsledek

["2","10","name"]

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