CKTIS / JavaScript
Object.values — hodnoty vlastních vlastností objektu
Object.values(obj) vrací nové pole s hodnotami vlastních, výčitatelných vlastností, jejichž klíče jsou řetězce. Vylučuje zděděné a nevýčitatelné vlastnosti i klíče typu Symbol.
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.values(obj)Object.values(obj) je statická metoda: volejte ji na Object, nikoli na zkoumaném objektu. Vrací nové pole obsahující pouze hodnoty vlastních, výčitatelných vlastností s řetězcovými klíči. Klíče ani dvojice klíč–hodnota nevrací. Zděděné vlastnosti, nevýčitatelné vlastnosti a vlastnosti s klíči typu Symbol jsou vyloučeny.
U běžných objektů se nejprve zpracují klíče, které jsou indexy pole, ve vzestupném číselném pořadí; ostatní řetězcové klíče následují v pořadí vytvoření vlastností. Nejde o řazení hodnot ani o abecední řazení klíčů. V příkladu je klíč 2 před 10 a oba jsou před label.
Argument se převede na objekt. null a undefined vyvolají TypeError; řetězec zpřístupňuje výčitatelné indexované vlastnosti, takže Object.values("abc") vytvoří ["a","b","c"]. Běžné primitivní číselné a logické hodnoty nemají žádné vlastní výčitatelné vlastnosti, a proto vytvoří [].
Nové pole neznamená hlubokou kopii: položky, jejichž hodnotou jsou objekty, zůstávají odkazy na tytéž objekty. Při čtení hodnot se volají gettery, které mohou mít vedlejší účinky nebo vyvolat výjimky. Samotná metoda do vlastností zdrojového objektu nezapisuje, ale kód spuštěný při čtení je může změnit.
Pří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ýsledek
["two","ten","item"]
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.