JS метод Object.valueOf()

Загальний опис

Метод Object.prototype.valueOf() є внутрішнім методом JavaScript, який дозволяє отримувати примітивне значення об'єкта. Його основна ціль полягає в тому, щоб повертати значення об'єкта як примітив, якщо таке значення існує, або сам об'єкт, якщо примітивного значення немає. Цей метод часто користується "під капотом" при автоматичному приведенні типів.

У більшості випадків при роботі зі стандартними об'єктами ви не помітите різниці між викликами valueOf() і просто об'єктом, адже для багатьох стандартних об'єктів метод повертає сам об'єкт. Наприклад:

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

Але для низькорівневих об'єктів, таких як числа, рядки та булеві значення, метод valueOf повертає їх примітивне значення:

const num = new Number(5);
console.log(num.valueOf()); // 5

Незважаючи на те, що Object.prototype.valueOf() часто використовується внутрішніми механізмами мови, його можна також перевизначити для ваших об'єктів, щоб забезпечити специфічну для типу логіку повертання значення. Це може бути корисним, наприклад, при створенні об'єктів, які поводять себе як примітиви. Наприклад:

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

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

const customNumber = new MyNumber(42);
console.log(customNumber + 8); // 50, завдяки перевизначеному методу valueOf

Для початківців важливо розуміти, що в JavaScript існують внутрішні методи, які роблять багато роботи "за лаштунками". Метод Object.prototype.valueOf() - один з таких методів, і навіть якщо ви не використовуєте його безпосередньо кожного дня, він допомагає системі коректно обробляти і приводити типи даних.

правити

Порада

У деяких випадках вам може знадобитися отримувати рядкове представлення об'єкта для відображення, але числове або інше примітивне значення для операцій. У таких випадках використовуйте valueOf() для отримання примітиву та toString() для отримання рядка.

автор: Bond правити

Порада

Для ваших власних користувацьких об'єктів ви можете перевизначити метод valueOf(), щоб він повертав більш змістовне або специфічне для контексту значення. Це особливо корисно, коли ви хочете, щоб ваш об'єкт вела себе певним чином при арифметичних операціях:

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

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

let x = new MyNumber(5);
console.log(x + 10); // 15

автор: Bond правити

Нотатка

Важливо зауважити, що для того, щоб valueOf був корисним під час конвертації типів, він повинен повертати примітив. Оскільки всі примітивні типи мають свої власні методи valueOf(), зазвичай виклик aPrimitiveValue.valueOf() не викликає Object.prototype.valueOf().

автор: Bond правити

Нотатка

Пам'ятайте, що Object.prototype.valueOf() зазвичай повертає об'єкт, для якого він викликається. Але для вбудованих об'єктів, таких як Number, String чи Boolean, цей метод повертає їх примітивне значення. Наприклад, при використанні методу на рядковому об'єкті, він поверне простий рядок:

let strObj = new String("Hello");
let primitiveStr = strObj.valueOf();
console.log(typeof primitiveStr); // "string"

автор: Bond правити

+ додати пораду чи нотатку

Синтаксис

valueOf()

Повернення

value

Повертає значення "this", перетворене на об'єкт.

автор: Bond

правити

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
	1	1	1	3	12	4

Підтримка: мобільні переглядачі

Переглядач
	1	18	4	1

Підтримка: серверні переглядачі

Переглядач
	0.10.0	1.0

Приклади

+ запропонувати свій приклад у пісочниці

let strObj = new String("Привіт, світ!");

// Використовуємо valueOf() для отримання примітивного рядка
let primStr = strObj.valueOf();

console.log(typeof strObj); // "object"
console.log(typeof primStr); // "string"
console.log(primStr);       // "Привіт, світ!"

function Person(name, age) {
    this.name = name;
    this.age = age;
}

Person.prototype.valueOf = function() {
    return this.age;
};

let person1 = new Person("Олег", 30);
let person2 = new Person("Марія", 25);

console.log(person1 > person2);  // true, бо 30 більше за 25