Object

Le constructeur Object crée un wrapper d'objet.

Syntaxe

// Initialisateur d'objet ou littéral { [ paireNomValeur1[, paireNomValeur2[,
 ...paireNomValeurN] ] ] }

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

Paramètres

paireNomValeur1, paireNomValeur2, ... paireNomValeurN
Paires de noms (chaînes) et de valeurs (toutes valeurs) où le nom est séparé de la valeur par deux points (:).
valeur
Toute valeur.

Description

Le constructeur Object crée un wrapper d'objet pour la valeur donnée. Si la valeur est null ou undefined, il créera et retournera un objet vide, sinon, il retournera un objet du Type qui correspond Ã  la valeur donnée. Si la valeur est déjà un objet, le constructeur retournera cette valeur.

Lorsqu'il n'est pas appelé dans un contexte constructeur, Object se comporte de façon identique à new Object().

Voir aussi initialisateur d'objet / syntaxe de littéral.

Propriétés du constructeur Object

Object.length
A une valeur de 1.
Object.prototype (en-US)
Permet l'ajout de propriétés à tous les objets de type Object.

Méthodes du constructeur Object

Object.assign()
Copie les valeurs de toutes propriétés propres énumérables depuis un ou plusieurs objets source dans un objet cible.
Object.create()
Crée un nouvel objet avec le prototype d'objet et les propriétés indiqués.
Object.defineProperty()
Ajoute à un objet la propriété nommée décrite par le descripteur donné.
Object.defineProperties()
Ajoute à un objet les propriétés nommées décrites par les descripteurs donnés.
Object.entries()
Retourne un tableau contenant les paires [clé, valeur] des propriétés énumérables propres (c'est-à-dire directement rattachées à l'objet) de l'objet donné et dont les clés sont des chaînes de caractères.
Object.freeze()
Gèle un objet : un autre code ne peut ni détruire ni changer aucune propriété.
Object.fromEntries()
Renvoie un nouvel objet à partir d'un itérable contenant des paires de clés-valeurs (l'opération duale de Object.entries).
Object.getOwnPropertyDescriptor()
Retourne un descripteur de propriété pour une propriété nommée d'un objet.
Object.getOwnPropertyDescriptors()
Retourne un objet contenant tous les descripteurs des propriétés propres d'un objet.
Object.getOwnPropertyNames()
Retourne un tableau contenant les noms de toutes les propriétés énumérables et non énumérables propres de l'objet donné.
Object.getOwnPropertySymbols()
Retourne un tableau de toutes les propriétés symboles trouvées directement dans un objet donné.
Object.getPrototypeOf()
Retourne le prototype de l'objet indiqué.
Object.is()
Détermine si deux valeurs sont la même valeur. Considère comme égales toutes les valeurs NaN (ce qui diffère à la fois de la Comparaison d'Égalité Abstraite et de la Comparaison d'Égalité Stricte).
Object.isExtensible()
Détermine si l'extension d'un objet est permise.
Object.isFrozen()
Détermine si un objet a été gelé.
Object.isSealed()
Détermine si un objet est scellé.
Object.keys()
Retourne un tableau contenant les noms de toutes les propriétés énumérables propres de l'objet donné.
Object.preventExtensions()
Empêche toute extension de l'objet.
Object.seal()
Empêche un autre code de détruire les propriétés d'un objet.
Object.setPrototypeOf()
Définit le prototype d'un objet (c-à-d, la propriété interne [[Prototype]]).
Object.values()
Retourne le tableau des valeurs énumérables propres de l'objet donné dont les clés sont des chaînes de caractères.

Instances d'Object et objet de prototype Object

Tous les objets en JavaScript descendent d'Object ; tous les objets héritent des méthodes et des propriétés de Object.prototype (en-US), même si elles peuvent être surchargées. Par exemple, d'autres prototypes de constructeurs surchargent la propriété du constructor et fournissent leurs propres méthodes toString(). Les changements apportés à l'objet de prototype Object sont propagées à tous les objets, à moins que les propriétés et méthodes auxquelles s'appliquent ces changements ne soient surchargées plus loin dans la chaîne de prototypes.

Propriétés

{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/prototype', 'Properties') }}

Méthodes

{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/prototype', 'Methods') }}

Suppression d'une propriété dans un objet

Il n'y a aucune méthode dans un Object lui-même pour supprimer ses propres propriétés (par exemple, comme Map.prototype.delete()). Pour ce faire, il faut utiliser l'opérateur delete.

Exemples

Utilisation d'Object avec les types undefined et null

Les exemples suivants stockent un Object vide dans o :

var o = new Object();
var o = new Object(undefined);
var o = new Object(null);

Utilisation d'Object pour créer des objets Boolean

Les exemples suivants stockent des objets Boolean dans o :

// Équivalent à : o = new Boolean(true);
var o = new Object(true);
// Équivalent à : o = new Boolean(false);
var o = new Object(Boolean());

Spécifications

Spécification Statut Commentaire
ECMAScript 1st Edition (ECMA-262) Standard Définition initiale. Implémentée par JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
La définition de 'Object' dans cette spécification.
Standard
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Object' dans cette spécification.
Standard Ajout de Object.assign, Object.getOwnPropertySymbols, Object.setPrototypeOf, Object.is
ECMAScript (ECMA-262)
La définition de 'Object' dans cette spécification.
Standard évolutif Ajout de Object.entries, de Object.values et de Object.getOwnPropertyDescriptors.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi