Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Object.values — valeurs des propriétés propres d’un objet

Object.values(obj) renvoie un nouveau tableau contenant les valeurs des propriétés propres, énumérables et dont les clés sont des chaînes. Les propriétés héritées ou non énumérables, ainsi que les clés Symbol, sont exclues.

Version : 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) est une méthode statique : appelez-la sur Object, et non sur l’objet examiné. Elle renvoie un nouveau tableau contenant uniquement les valeurs des propriétés propres, énumérables et dont les clés sont des chaînes. Elle ne renvoie ni les clés ni les paires clé-valeur. Les propriétés héritées, les propriétés non énumérables et celles dont les clés sont des Symbol sont exclues.

Pour les objets ordinaires, les clés correspondant à des indices de tableau sont traitées en premier, par ordre numérique croissant ; les autres clés de type chaîne suivent dans l’ordre de création des propriétés. Il ne s’agit ni d’un tri des valeurs ni d’un tri alphabétique des clés. Dans l’exemple, la clé 2 précède 10, et toutes deux précèdent label.

L’argument est converti en objet. null et undefined déclenchent un TypeError ; une chaîne expose des propriétés indexées énumérables, donc Object.values("abc") produit ["a","b","c"]. Les primitives ordinaires de type nombre ou booléen n’ont aucune propriété propre énumérable et produisent donc [].

Un nouveau tableau ne signifie pas une copie profonde : les valeurs qui sont des objets restent des références aux mêmes objets. La lecture des valeurs déclenche les accesseurs, qui peuvent avoir des effets de bord ou lever des exceptions. La méthode elle-même n’écrit pas dans les propriétés de la source, mais le code exécuté pendant les lectures peut les modifier.

Exemples

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)));

Résultat

["two","ten","item"]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources