Object

Le constructeur Object crée une enveloppe (wrapper) pour représenter un objet.

Syntaxe

// Littéral objet (aussi appelé initialisateur d'objet)
{ [ nomValeurPaire[, nomValeurPaire2[, ...nomValeurPaireN] ] ] }

// Appelé comme un constructeur
new Object([valeur])

Paramètres

nomValeurPaire1, nomValeurPaire2, ... nomValeurPaireN

Des paires de noms (des chaînes de caractères) et de valeurs (n'importe quelles valeurs), le nom est séparé de la valeur par deux points (:).

valeur

N'import quelle valeur.

Description

Le constructeur Object permet de créer un objet autour d'une valeur donnée. Si la valeur est null ou undefined, un objet vide sera créé et renvoyé. Sinon, un objet du type correspondant sera renvoyé, si la valeur est déjà un objet, le constructeur renverra cette valeur.

Lorsque le constructeur est appelé comme une fonction classique (sans l'opérateur new), Object se comportera de la même façon que to new Object().

Voir également les littéraux objets.

Propriétés

Object.length

Ce constructeur a une propriété de longueur de 1.

Object.prototype

Cette propriété permet d'ajouter des propriétés à toutes les instances (c'est-à-dire tous les objets) via la chaîne de prototypes.

Méthodes

Object.assign()

Crée un nouvel objet en copiant les valeurs des propriétés énumérables de un ou plusieurs objets.

Object.create()

Crée un nouvel objet avec un prototype donnée et des propriétés données.

Object.defineProperty()

Ajoute une propriété à un objet, cette propriété nommée est décrite par le descripteur fourni.

Object.defineProperties()

Ajoute des propriétés à un objet qui sont décrites par les descripteurs respectifs.

Object.freeze()

Gèle un objet : on ne peut ni supprimer ni modifier ses propriétés.

Object.getOwnPropertyDescriptor()

Renvoie un descripteur de propriété pour une certaine propriété nommée d'un objet.

Object.getOwnPropertyNames()

Renvoie un tableau contenant les noms de toutes les propriétés propres à l'objet qui sont énumérables et non-énumérables (les propriétés propres sont celles directement rattachées à l'objet, qui ne sont pas héritées par la chaîne de prototypes).

Object.getOwnPropertySymbols()

Renvoie un tableau de toutes les propriétés propres d'un objet qui sont des symboles (les propriétés propres sont celles qui ne sont pas héritées).

Object.getPrototypeOf()

Renvoie le prototype d'un objet donné.

Object.is()

Compare si deux valeurs sont les mêmes.

Object.isExtensible()

Détermine s'il est possible d'étendre un objet.

Object.isFrozen()

Détermine si un objet a été gelé.

Object.isSealed()

Détermine si un objet est scellé.

Object.keys()

Renvoie un tableau qui contient les noms de toutes les propriétés propres d'un objet qui sont énumérables (les propriétés propres sont celles qui ne sont pas héritées).

Object.observe()

Observe, de façon asynchrone, les modifications apportées à un objet.

Object.preventExtensions()

Empêche l'extension de l'objet.

Object.seal()

Empêche qu'un code tierce supprime les propriétés d'un objet.

Object.setPrototypeOf()

Définit le prototype d'un objet (c'est-à-dire la propriété interne [[Prototype]])

Les instances d'Object et son prototype

En JavaScript, tous les objets héritent d'Object ; tous les objets bénéficient donc des méthodes et des propriétés de Object.prototype même si ces méthodes et propriétés peuvent être surchargées si elles sont redéfinies en aval dans la chaîne de prototypes. Ainsi, certains prototypes de constructeurs fournissent leurs propres méthodes pour toString(). Les modifications apportées au prototype d'Object sont propagées sur tous les objets via la chaîne de prototypes sauf si les propriétés et/ou méthodes concernées ont été surchargées.

Propriétés

Méthodes

Exemples

Utiliser Object avec les types undefined et null

Dans les exemples suivants, on stocke un objet vide dans la variable o :

var o = new Object();

var o = new Object(undefined);

var o = new Object(null);

Utiliser Object pour créer des objets Boolean

Dans les exemples suivantes, on affecte une valeur qui est un objet Boolean à o :

// est équivalent à : o = new Boolean(true);
var o = new Object(true);

// est équivalent à : o = new Boolean(false);
var o = new Object(Boolean());

Spécifications

Compatibilité des navigateurs

Voir aussi

• Les initialisateurs objets
• Les structures de données en JavaScript
• L'héritage et la chaîne de prototypes