Object.prototype.valueOf()

Exemple interactif

function MyNumberType(n) {
  this.number = n;
}

MyNumberType.prototype.valueOf = function () {
  return this.number;
};

const object1 = new MyNumberType(4);

console.log(object1 + 3);
// Expected output: 7

Syntaxe

object.valueOf();

Valeur de retour

La valeur primitive de l'objet appelant.

Description

JavaScript appelle la mthode valueOf pour convertir un objet en une valeur primitive. Il est rarement ncessaire d'appeler soi-mme la mthode valueOf ; JavaScript l'invoque automatiquement lorsqu'il rencontre un objet alors qu'il attend une valeur primitive.

Par dfaut, la mthode valueOf est hrite par tout objet descendant d'Object. Tous les objets globaux natifs redfinissent cette mthode pour renvoyer une valeur approprie. Si un objet n'a pas de valeur primitive, valueOf renvoie l'objet lui-mme, ce qui sera affich comme :

[object Object]

valueOf peut tre utilise afin de convertir un objet prdfini en une valeur primitive. Si un objet est dfini dans un script, il est possible de surcharger Object.prototype.valueOf pour appeler une mthode personnalise au lieu de la mthode par dfaut d'Object.

Surcharger valueOf pour des objets personnaliss

Il est possible de crer une fonction appeler la place de la mthode valueOf par dfaut. Celle-ci ne peut pas recevoir de paramtres.

Supposons qu'on ait un type d'objet monTypeDeNombre et qu'on dsire lui ajouter une mthode valueOf spcifique, on pourra utiliser le code suivant :

monTypeDeNombre.prototype.valueOf = function () {
  return valeurPrimitive;
};

En utilisant ce code, chaque fois qu'un objet de type monTypeDeNombre sera utilis dans un contexte o il doit tre reprsent comme une valeur primitive, JavaScript appellera automatiquement la fonction qui y est dfinie.

C'est habituellement JavaScript qui invoquera la mthode valueOf, mais il est aussi possible de l'appeler soi-mme :

monNombre.valueOf();

Exemples

Utiliser valueOf

function MonTypeDeNombre(n) {
  this.nombre = n;
}

MonTypeDeNombre.prototype.valueOf = function () {
  return this.nombre;
};

var monObj = new MonTypeDeNombre(4);
console.log(monObj + 3); // 7 car l'opration a implicitement utilis valueOf

Spcifications

Compatibilit des navigateurs

Voir aussi

• Object.prototype.toString()
• parseInt()
• Symbol.toPrimitive