CKTIS / JavaScript
Object.values — vrednosti lastnih lastnosti objekta
Object.values(obj) vrne novo polje z vrednostmi lastnih, naštetnih lastnosti, katerih ključi so nizi. Izpusti podedovane in nenaštetne lastnosti ter ključe Symbol.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
Object.values(obj)Object.values(obj) je statična metoda: pokličite jo na Object, ne na objektu, ki ga pregledujete. Vrne novo polje, ki vsebuje samo vrednosti lastnih, naštetnih lastnosti z nizi kot ključi. Ključev ali parov ključ-vrednost ne vrne. Podedovane lastnosti, nenaštetne lastnosti in lastnosti s ključi Symbol so izpuščene.
Pri običajnih objektih se najprej obdelajo ključi, ki so indeksi polja, v naraščajočem številčnem vrstnem redu; drugi nizi kot ključi sledijo po vrstnem redu nastanka lastnosti. To ni razvrščanje vrednosti ali abecedno razvrščanje ključev. V primeru je ključ 2 pred 10, oba pa sta pred label.
Argument se pretvori v objekt. null in undefined sprožita TypeError; niz izpostavi naštetne indeksirane lastnosti, zato Object.values("abc") ustvari ["a","b","c"]. Običajne primitivne številske in logične vrednosti nimajo lastnih naštetnih lastnosti, zato ustvarijo [].
Novo polje ne pomeni globoke kopije: vnosi, katerih vrednosti so objekti, ostanejo sklici na iste objekte. Branje vrednosti sproži getterje, ki imajo lahko stranske učinke ali vržejo izjeme. Metoda sama ne zapisuje v lastnosti izvornega objekta, vendar jih lahko spremeni koda, ki se izvede med branjem.
Primeri
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)));Rezultat
["two","ten","item"]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.