CKTIS / JavaScript
Object.values — waarden van de eigen eigenschappen van een object
Object.values(obj) geeft een nieuwe array met de waarden van eigen, opsombare eigenschappen met tekenreekssleutels. Overgeërfde en niet-opsombare eigenschappen en Symbol-sleutels worden uitgesloten.
Versie: 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) is een statische methode: roep deze aan op Object, niet op het object dat je onderzoekt. De methode geeft een nieuwe array terug met alleen de waarden van eigen, opsombare eigenschappen met tekenreekssleutels. Sleutels of sleutel-waardeparen worden niet teruggegeven. Overgeërfde eigenschappen, niet-opsombare eigenschappen en eigenschappen met Symbol-sleutels worden uitgesloten.
Bij gewone objecten worden sleutels die array-indexen zijn eerst verwerkt, in oplopende numerieke volgorde; andere tekenreekssleutels volgen in de volgorde waarin de eigenschappen zijn aangemaakt. Dit is geen sortering van waarden en ook geen alfabetische sortering van sleutels. In het voorbeeld komt sleutel 2 vóór 10, en beide komen vóór label.
Het argument wordt omgezet naar een object. null en undefined veroorzaken een TypeError; een tekenreeks heeft opsombare geïndexeerde eigenschappen, dus Object.values("abc") levert ["a","b","c"] op. Gewone primitieve getallen en booleans hebben geen eigen opsombare eigenschappen en leveren daarom [] op.
Een nieuwe array betekent niet dat er een diepe kopie wordt gemaakt: waarden die objecten zijn, blijven verwijzingen naar dezelfde objecten. Bij het lezen van waarden worden getters aangeroepen; die kunnen neveneffecten hebben of uitzonderingen veroorzaken. De methode zelf schrijft niet naar eigenschappen van de bron, maar code die tijdens het lezen wordt uitgevoerd kan ze wijzigen.
Voorbeelden
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)));Resultaat
["two","ten","item"]
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.