Constructeur Object()

Syntaxe

new Object()
new Object(value)

Object()
Object(value)

Paramtres

value Facultatif

N'importe quelle valeur.

Valeur de retour

Lorsque le constructeur Object() lui-mme est appel ou construit, sa valeur de retour est un objet :

• Si la valeur est null ou undefined, il cre et retourne un objet vide.
• Si la valeur est dj un objet, il retourne cette valeur.
• Sinon, il retourne un objet d'un type correspondant la valeur donne. Par exemple, passer un primitif BigInt retourne un objet wrapper BigInt.

Lorsque Object() est construit mais que new.target n'est pas le constructeur Object lui-mme, le comportement est lgrement diffrent : il initialise un nouvel objet avec new.target.prototype comme prototype. Toute valeur d'argument est ignore. Cela peut se produire, par exemple, lorsque Object() est appel implicitement avec super() dans le constructeur d'une classe qui tend Object. Dans ce cas, mme si vous passez un nombre super(), la valeur de this l'intrieur du constructeur ne devient pas une instance de Number.

Exemples

Crer un nouvel objet

const o = new Object();
o.toto = 42;

console.log(o);
// Object { toto: 42 }

Utiliser Object() avec des types undefined et null

Dans l'exemple suivant, on cre un objet vide dans la variable o :

const o = new Object();

const o = new Object(undefined);

const o = new Object(null);

Obtenir des objets enveloppants pour BigInt et Symbol

Les constructeurs BigInt() et Symbol() lvent une erreur lorsqu'ils sont appels avec new, pour viter l'erreur courante consistant crer un objet wrapper au lieu de la valeur primitive. La seule faon de crer un objet wrapper pour ces types est d'appeler Object() avec eux :

const objetNombre = new Number(1);
console.log(typeof objetNombre); // "object"

const objetGrandEntier = Object(1n);
console.log(typeof objetGrandEntier); // "object"

const objetSymbole = Object(Symbol("toto"));
console.log(typeof objetSymbole); // "object"

Spcifications

Compatibilit des navigateurs

Voir aussi

• Initialisation d'objet