Object.prototype.valueOf()

Keine.

Der this Wert, in ein Objekt konvertiert.

JavaScript ruft die valueOf Methode auf, um ein Objekt in einen primitiven Wert umzuwandeln. Sie müssen die valueOf Methode selten selbst aufrufen; JavaScript ruft sie automatisch auf, wenn ein Objekt erwartet wird, wo normalerweise ein primitiver Wert erwartet wird.

Diese Methode wird bevorzugt von der numerischen Umwandlung und der primitiven Umwandlung aufgerufen, allerdings ruft die String-Umwandlung bevorzugt toString() auf, und toString() gibt sehr wahrscheinlich einen String-Wert zurück (selbst für die Basisimplementierung Object.prototype.toString()), daher wird valueOf() in diesem Fall normalerweise nicht aufgerufen.

Alle Objekte, die von Object.prototype erben (d.h. alle außer Objekte mit null-Prototyp), erben die toString() Methode. Die Basisimplementierung Object.prototype.valueOf() ist absichtlich nutzlos: Da sie ein Objekt zurückgibt, wird ihr Rückgabewert niemals von einem Algorithmus der primitiven Umwandlung verwendet. Viele eingebaute Objekte überschreiben diese Methode, um einen geeigneten primitiven Wert zurückzugeben. Wenn Sie ein benutzerdefiniertes Objekt erstellen, können Sie valueOf() überschreiben, um eine benutzerdefinierte Methode aufzurufen, sodass Ihr benutzerdefiniertes Objekt in einen primitiven Wert umgewandelt werden kann. Im Allgemeinen wird valueOf() verwendet, um einen Wert zurückzugeben, der für das Objekt am sinnvollsten ist — im Gegensatz zu toString() muss es sich nicht um einen String handeln. Alternativ können Sie eine [Symbol.toPrimitive]() Methode hinzufügen, die noch mehr Kontrolle über den Umwandlungsprozess ermöglicht und immer gegenüber valueOf oder toString bei jeder Typumwandlung bevorzugt wird.

Die Basis valueOf() Methode gibt den this Wert selbst zurück, konvertiert in ein Objekt, wenn es nicht bereits eines ist. Daher wird ihr Rückgabewert niemals von einem primitiven Umwandlungsalgorithmus verwendet.

const obj = { foo: 1 };
console.log(obj.valueOf() === obj); // true

console.log(Object.prototype.valueOf.call("primitive"));
// [String: 'primitive'] (a wrapper object)

Sie können eine Funktion erstellen, die anstelle der Standardmethode valueOf aufgerufen wird. Ihre Funktion sollte keine Argumente annehmen, da sie keine bei der Typumwandlung übergeben bekommt.

Zum Beispiel können Sie eine valueOf Methode zu Ihrer benutzerdefinierten Klasse Box hinzufügen.

class Box {
  #value;
  constructor(value) {
    this.#value = value;
  }
  valueOf() {
    return this.#value;
  }
}

Mit dem obigen Code wird jedes Mal, wenn ein Objekt des Typs Box in einem Kontext verwendet wird, in dem es als primitiver Wert (aber nicht speziell als String) dargestellt werden soll, automatisch die Funktion im obigen Code aufgerufen.

const box = new Box(123);
console.log(box + 456); // 579
console.log(box == 123); // true

Die valueOf Methode eines Objekts wird normalerweise von JavaScript aufgerufen, Sie können sie jedoch selbst wie folgt aufrufen:

box.valueOf();

Unäres Plus führt eine Zahlenumwandlung an seinem Operanden durch, was bei den meisten Objekten ohne [Symbol.toPrimitive]() bedeutet, dass valueOf() aufgerufen wird. Wenn das Objekt jedoch keine benutzerdefinierte valueOf() Methode hat, bewirkt die Basisimplementierung, dass valueOf() ignoriert wird und der Rückgabewert von toString() stattdessen verwendet wird.

+new Date(); // the current timestamp; same as new Date().getTime()
+{}; // NaN (toString() returns "[object Object]")
+[]; // 0 (toString() returns an empty string list)
+[1]; // 1 (toString() returns "1")
+[1, 2]; // NaN (toString() returns "1,2")
+new Set([1]); // NaN (toString() returns "[object Set]")
+{ valueOf: () => 42 }; // 42

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