CKTIS / JavaScript
Object.values — hodnoty vlastných vlastností objektu
Object.values(obj) vracia nové pole s hodnotami vlastných, enumerovateľných vlastností, ktorých kľúče sú reťazce. Vylučuje zdedené a neenumerovateľné vlastnosti aj kľúče typu Symbol.
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.values(obj)Object.values(obj) je statická metóda: volajte ju na Object, nie na skúmanom objekte. Vracia nové pole obsahujúce iba hodnoty vlastných, enumerovateľných vlastností s reťazcovými kľúčmi. Kľúče ani dvojice kľúč–hodnota nevracia. Zdedené vlastnosti, neenumerovateľné vlastnosti a vlastnosti s kľúčmi typu Symbol sú vylúčené.
Pri bežných objektoch sa najprv spracujú kľúče, ktoré sú indexmi poľa, vo vzostupnom číselnom poradí; ostatné reťazcové kľúče nasledujú v poradí vytvorenia vlastností. Nejde o triedenie hodnôt ani o abecedné triedenie kľúčov. V príklade je kľúč 2 pred 10 a oba sú pred label.
Argument sa prevedie na objekt. null a undefined vyvolajú TypeError; reťazec sprístupňuje enumerovateľné indexované vlastnosti, takže Object.values("abc") vytvorí ["a","b","c"]. Bežné primitívne číselné a logické hodnoty nemajú vlastné enumerovateľné vlastnosti, a preto vytvoria [].
Nové pole neznamená hlbokú kópiu: položky, ktorých hodnotou sú objekty, zostávajú odkazmi na tie isté objekty. Pri čítaní hodnôt sa volajú gettery, ktoré môžu mať vedľajšie účinky alebo vyvolať výnimky. Samotná metóda do vlastností zdrojového objektu nezapisuje, ale kód spustený počas čítania ich môže zmeniť.
Príklady
const record = Object.create({ inherited: "ignored" });
record.label = "item";
record[10] = "ten";
record[2] = "two";
Object.defineProperty(record, "hidden", { value: "ignored" });
record[Symbol("secret")] = "ignored";
console.log(JSON.stringify(Object.values(record)));Výsledok
["two","ten","item"]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.