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
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, 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

Méthodes

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