Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Object.values()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2017.
La méthodeObject.values() renvoie un tableau contenant les valeurs des propriétés propres énumérables d'un objet dont l'ordre est le même que celui obtenu avec une bouclefor...in (la bouclefor-in est différente car elle parcourt également les propriétés héritées).
Exemple interactif
const object1 = { a: "somestring", b: 42, c: false,};console.log(Object.values(object1));// Expected output: Array ["somestring", 42, false]Syntaxe
Object.values(obj);Paramètres
objL'objet dont on souhaite connaître les valeurs des propriétés propres énumérables.
Valeur de retour
Un tableau dont les éléments sont les valeurs des propriétés énumérables de l'objet passé en argument.
Description
Object.values() renvoie un tableau dont les éléments sont les valeurs des propriétés énumérables directement rattachées à l'objet passé en argument. L'ordre du tableau est le même que celui obtenu lorsqu'on parcourt les propriétés manuellement.
Exemples
var obj = { toto: "truc", machin: 42 };console.log(Object.values(obj)); // ['truc', 42]// un objet semblable à un tableauvar obj = { 0: "a", 1: "b", 2: "c" };console.log(Object.values(obj)); // ['a', 'b', 'c']// un objet semblable à un tableau// dont les clés sont ordonnées aléatoirement// lorsque des clés numériques sont utilisées, les valeurs sont// renvoyées selon l'ordre numérique des clésvar un_obj = { 100: "a", 2: "b", 7: "c" };console.log(Object.values(un_obj)); // ['b', 'c', 'a']// getToto est une propriété qui// n'est pas énumérablevar mon_obj = Object.create( {}, { getToto: { value: function () { return this.toto; }, }, },);mon_obj.toto = "truc";console.log(Object.values(mon_obj)); // ['truc']// un argument de type primitif sera// converti en un objetconsole.log(Object.values("toto")); // ['t', 'o', 't', 'o']Prothèse d'émulation (polyfill)
Afin d'ajouter le support pourObject.values dans des environnements plus anciens qui ne supportent pas la méthode nativement, vous pouvez utiliser une prothèse comme celle proposée sur le dépôttc39/proposal-object-values-entries ou sur le dépôtes-shims/Object.values.
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.values |