[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Object/values [Back]  [Original]

Object.values() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

Object.values()

Baseline Large disponibilit

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 mthode Object.values() renvoie un tableau contenant les valeurs des proprits propres numrables d'un objet dont l'ordre est le mme que celui obtenu avec une boucle for...in (la boucle for-in est diffrente car elle parcourt galement les proprits hrites).

Dans cet article

Exemple interactif

const object1 = {
  a: "somestring",
  b: 42,
  c: false,
};

console.log(Object.values(object1));
// Expected output: Array ["somestring", 42, false]

Syntaxe

js
Object.values(obj);

Paramtres

obj

L'objet dont on souhaite connatre les valeurs des proprits propres numrables.

Valeur de retour

Un tableau dont les lments sont les valeurs des proprits numrables de l'objet pass en argument.

Description

Object.values() renvoie un tableau dont les lments sont les valeurs des proprits numrables directement rattaches l'objet pass en argument. L'ordre du tableau est le mme que celui obtenu lorsqu'on parcourt les proprits manuellement.

Exemples

js
var obj = { toto: "truc", machin: 42 };
console.log(Object.values(obj)); // ['truc', 42]

// un objet semblable  un tableau
var obj = { 0: "a", 1: "b", 2: "c" };
console.log(Object.values(obj)); // ['a', 'b', 'c']

// un objet semblable  un tableau
// dont les cls sont ordonnes alatoirement
// lorsque des cls numriques sont utilises, les valeurs sont
// renvoyes selon l'ordre numrique des cls
var un_obj = { 100: "a", 2: "b", 7: "c" };
console.log(Object.values(un_obj)); // ['b', 'c', 'a']

// getToto est une proprit qui
// n'est pas numrable
var 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 objet
console.log(Object.values("toto")); // ['t', 'o', 't', 'o']

Prothse d'mulation (polyfill)

Afin d'ajouter le support pour Object.values dans des environnements plus anciens qui ne supportent pas la mthode nativement, vous pouvez utiliser une prothse comme celle propose sur le dpt tc39/proposal-object-values-entries ou sur le dpt es-shims/Object.values.

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-object.values

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page