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.create()
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 juillet 2015.
La méthodeObject.create() crée un nouvel objet avec un prototype donné et des propriétés données.
Dans cet article
Exemple interactif
const person = { isHuman: false, printIntroduction: function () { console.log(`My name is ${this.name}. Am I human? ${this.isHuman}`); },};const me = Object.create(person);me.name = "Matthew"; // "name" is a property set on "me", but not on "person"me.isHuman = true; // Inherited properties can be overwrittenme.printIntroduction();// Expected output: "My name is Matthew. Am I human? true"Syntaxe
Object.create(proto);Object.create(proto, objetPropriétés);Paramètres
protoL'objet qui sera le prototype du nouvel objet créé.
objetPropriétésParamètre optionnel. S'il est fourni et qu'il ne vaut pas
undefined, il sera utilisé comme un objet dont les propriétés propres (celles qui ne sont pas héritées par la chaîne de prototypes) et énumérables définiront des descripteurs pour les propriétés à ajouter au nouvel objet, avec les mêmes noms. Ces propriétés correspondent au deuxième argument deObject.defineProperties().
Valeur de retour
Un nouvel objet qui dispose du prototype et des propriétés indiquées.
Exceptions
Cette méthode lève une exceptionTypeError si le paramètreobjetPropriétés vautnull ou s'il ne décrit pas des propriétés d'un objet.
Exemples
>L'héritage classique avecObject.create()
Dans l'exemple ci-dessous, on utiliseObject.create() afin de réaliser un héritage de classe. Ce modèle ne supporte que l'héritage unique (un objet hérite directement uniquement d'un autre objet) car JavaScript ne gère pas l'héritage multiple.
// Forme, la classe parentefunction Forme() { this.x = 0; this.y = 0;}// Méthode de la classe parenteForme.prototype.déplacer = function (x, y) { this.x += x; this.y += y; console.info("Forme déplacée.");};// Rectangle - classe fillefunction Rectangle() { // on appelle le constructeur parent Forme.call(this);}// La classe fille surcharge la classe parenteRectangle.prototype = Object.create(Forme.prototype);// Si on ne définit pas le constructeur avec Rectangle, il récupèrera le constructeur// Forme (le parent).Rectangle.prototype.constructor = Rectangle;var rect = new Rectangle();console.log("instance de Rectangle ? ", rect instanceof Rectangle);// trueconsole.log("une instance de Forme ? ", rect instanceof Forme);// truerect.déplacer(1, 1);// Affiche 'Forme déplacée.'Si on souhaite hériter de plusieurs objets, on peut utiliser desmixins.
function MaClasse() { ClasseParente1.call(this); ClasseParente2.call(this);}MaClasse.prototype = Object.create(ClasseParente1.prototype); // héritage d'une classeObject.assign(MaClasse.prototype, ClasseParente2.prototype); // mixin pour une autreMaClasse.prototype.constructor = MaClasse; // On réaffecte le constructeurMaClasse.prototype.maMéthode = function () { // faire quelque chose};Ici, la méthodeObject.assign() copie les propriétés du prototype de la classe parente (ClassParente2) sur le prototype de la classe fille (MaClasse), les rendant disponibles pour toutes les instances deMaClasse.Object.assign() a été introduit avec ES2015 etune prothèse d'émulation (polyfill) est disponible. Si le support des navigateurs plus anciens est nécessaire, les méthodesjQuery.extend() ou_.assign() (Lodash) peuvent être utilisées.
Utiliser l'argumentobjetPropriétés avecObject.create()
var o;// on crée un objet avec null// comme prototypeo = Object.create(null);o = {};// est équivalent à :o = Object.create(Object.prototype);// Exemple où on crée un objet avec quelques propriétés// (On voit ici que le second paramètres fait correspondre les clés// avec des descripteurs de propriétés.)o = Object.create(Object.prototype, { // toto est une propriété de donnée toto: { writable: true, configurable: true, value: "hello" }, // truc est une propriété d'accesseur/mutateur truc: { configurable: false, get: function () { return 10; }, set: function (value) { console.log("Définir `o.truc` à", value); }, /* avec les accesseurs ES2015 on aura : get() { return 10; }, set(value) { console.log('Définir `o.truc` à', value); } */ },});function Constructeur() {}o = new Constructeur();// est équivalent à :o = Object.create(Constructeur.prototype);// Bien entendu, si la fonction Constructeur// possède des instructions pour l'initialisation,// Object.create() ne pourra pas le reproduire// on crée un nouvel objet dont le prototype est// un nouvel objet vide et on y ajoute une propriété// 'p' qui vaut 42o = Object.create({}, { p: { value: 42 } });// par défaut, les propriétés ne sont PAS// écrivables, énumérables ou configurableso.p = 24;o.p;// 42o.q = 12;for (var prop in o) { console.log(prop);}// 'q'delete o.p;// false// Pour définir une propriété selon ES3o2 = Object.create( {}, { p: { value: 42, writable: true, enumerable: true, configurable: true, }, },);// Équivalent à// o2 = Object.create({p: 42});Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-object.create> |
Compatibilité des navigateurs
Voir aussi
Object.defineProperty()Object.defineProperties()Object.prototype.isPrototypeOf()- Le billet de John Resig sur
getPrototypeOf()(en anglais)