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

CKTIS / JavaScript

Object.fromEntries — créer un objet à partir de paires clé-valeur

Object.fromEntries crée un nouvel objet à partir d’une collection itérable d’entrées clé-valeur. La méthode accepte les clés chaîne et symbole ; en cas de clé répétée, la dernière valeur est conservée. Elle sert notamment à transformer des entrées ou à convertir une Map en objet.

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.fromEntries(iterable)

Object.fromEntries(iterable) est une méthode statique introduite dans ECMAScript 2019, et non une API Web. Elle accepte un objet itérable, par exemple un tableau de paires ou une Map, et renvoie un nouvel objet ordinaire dont le prototype est Object.prototype. Vérifiez sa disponibilité dans l’environnement cible avec typeof Object.fromEntries === "function" ; la version de Node utilisée dans un dépôt ne permet pas de conclure à la prise en charge par les navigateurs.

Chaque entrée doit être un objet : la méthode lit ses propriétés 0 et 1 comme clé et valeur. Les entrées elles-mêmes n’ont pas besoin d’être itérables. Si la propriété 1 manque, la valeur obtenue est undefined ; les éléments supplémentaires sont ignorés. Un argument non itérable ou une entrée qui est une valeur primitive provoque une TypeError.

Pour obtenir une clé de propriété, la méthode convertit d’abord la clé en valeur primitive si c’est un objet. Si la valeur primitive est un symbole, elle est utilisée telle quelle ; sinon, elle est convertie en chaîne. Si des clés se répètent après conversion, la dernière valeur l’emporte. Le résultat comporte des propriétés de données propres, modifiables, énumérables et configurables. Une entrée "__proto__" crée une propriété propre au lieu de modifier le prototype.

Une démarche courante consiste à utiliser Object.entries(obj), puis map ou filter, et enfin Object.fromEntries(...). Ce n’est toutefois pas une inversion complète : Object.entries omet les symboles et les propriétés non énumérables, et les descripteurs ne sont pas conservés. Les valeurs objets restent des références : il ne s’agit pas d’une copie profonde.

Exemples

const token = Symbol("token");
const entries = [["score", 10], ["score", 20], [token, "ok"]];
const result = Object.fromEntries(entries);

console.log(result.score);
console.log(result[token]);
console.log(Object.entries(result).length);

Résultat

20
ok
1

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