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

CKTIS / JavaScript

Object.keys — vlastné enumerovateľné kľúče objektu

Object.keys(obj) vracia nové pole vlastných enumerovateľných reťazcových kľúčov objektu. Vylučuje zdedené a neenumerovateľné vlastnosti aj kľúče Symbol. Pri bežných objektoch sa kľúče, ktoré sú indexmi poľa, zobrazia pred ostatnými reťazcovými kľúčmi.

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

Object.keys(obj)

Object.keys(obj) je statická metóda objektu Object, ktorá vracia nové pole názvov vlastností. Zahŕňa iba vlastné vlastnosti, teda tie, ktoré nie sú zdedené z prototypu, ktorých atribút enumerable má hodnotu true a ktorých kľúčom je reťazec. Výsledok obsahuje reťazce, aj keď boli kľúče zapísané ako čísla. Kľúče Symbol sú vylúčené.

Pri bežných objektoch sa kľúče, ktoré sú indexmi poľa, zoradia vzostupne podľa číselnej hodnoty; potom nasledujú ostatné reťazcové kľúče v poradí vytvorenia vlastností. Nejde o abecedné triedenie ani o pravidlo pre každý reťazec pripomínajúci číslo: "02" nie je index poľa. Objekty Proxy môžu ovplyvniť poradie a počas výpisu vykonávať kód.

Na rozdiel od for...in metóda nezahŕňa zdedené enumerovateľné vlastnosti. Reflect.ownKeys(obj) naopak zahŕňa aj vlastné neenumerovateľné vlastnosti a kľúče Symbol. Samotné Object.keys nečíta hodnoty vlastností ani nevolá ich gettery; vrátené pole sa pri zmene objektu neaktualizuje.

null a undefined spôsobia TypeError. Ostatné primitívne hodnoty sa skonvertujú na objekty: Object.keys("ab") vráti ["0","1"], zatiaľ čo Object.keys(42) vráti []. Ide o API jazyka ECMAScript, nie o API prehliadača; spustenie príkladu v Node.js nedokazuje kompatibilitu s konkrétnym prehliadačom.

Prí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ýsledok

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

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

Zdroje