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

CKTIS / JavaScript

Object.create : prototype explicite d’un nouvel objet

Object.create crée un objet ordinaire avec exactement le prototype indiqué et, facultativement, des descripteurs propres.

Version : ECMAScript 5 onward; example target: Node.js 24.22.2

Syntaxe

Object.create(proto, properties)

Object.create(proto, properties) exige que proto soit un objet ou null ; un nombre, une chaîne ou une autre primitive lève TypeError sans encapsulation. Le nouvel objet ordinaire renvoyé a proto pour [[Prototype]] interne. null crée un objet sans Object.prototype, utile comme dictionnaire mais dépourvu de méthodes héritées.

Le paramètre facultatif properties est traité comme par Object.defineProperties : ses clés propres énumérables, chaînes ou symboles, associent des noms à des descripteurs. Les champs absents prennent des valeurs restrictives : writable, enumerable et configurable valent false, tandis que value, get et set valent undefined. Ce n’est pas une copie ordinaire de valeurs.

La méthode existe depuis ECMAScript 5. properties égal à null, un descripteur invalide ou un getter/piège Proxy peut lever une exception. Les propriétés héritées sont lues via la chaîne mais restent au prototype ; modifier celui-ci peut toucher tous les objets créés. Pour des données externes, impose une liste de clés même avec un prototype nul.

Exemples

const proto = {
  role: "reader",
  describe() { return `${this.name}:${this.role}`; }
};
const user = Object.create(proto, {
  name: { value: "Ada", writable: true, enumerable: true, configurable: true },
  secret: { value: 7 }
});
console.log(Object.getPrototypeOf(user) === proto, user.describe());
console.log(Object.keys(user).join(","), Object.hasOwn(user, "role"));
const dictionary = Object.create(null);
dictionary.__proto__ = "data";
console.log(Object.getPrototypeOf(dictionary), dictionary.__proto__);
try { Object.create(42); } catch (error) { console.log(error.name); }

Résultat

true Ada:reader
name false
null data
TypeError

L’exemple crée un objet avec prototype et descripteurs, puis un dictionnaire à prototype nul.

Sources