Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update(JS): web/javascript/reference/global_objects/object/valueof #3143

Merged
merged 1 commit into from
Jul 17, 2024
Merged

update(JS): web/javascript/reference/global_objects/object/valueof #3143

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions files/uk/web/javascript/reference/global_objects/object/valueof/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ JavaScript викликає метод `valueOf` для [перетворенн

Цей метод у першу чергу викликається алгоритмами [зведення до числового значення](/uk/docs/Web/JavaScript/Data_structures#zvedennia-do-chysla) та [зведення до примітива](/uk/docs/Web/JavaScript/Data_structures#zvedennia-do-prymityva), однак [зведення до рядка](/uk/docs/Web/JavaScript/Reference/Global_Objects/String#zvedennia-do-riadka) у першу чергу викликає `toString()`, а `toString()`, із високою імовірністю, поверне рядкове значення (навіть у базовій реалізації {{jsxref("Object.prototype.toString()")}}), тож `valueOf()` у цьому випадку зазвичай не викликається.

Усі об'єкти, що успадковують від `Object.prototype` (тобто всі, крім [`null`-прототипних об'єктів](/uk/docs/Web/JavaScript/Reference/Global_Objects/Object#null-prototypni-obiekty)), успадковують метод `toString()`. Базова реалізація `Object.prototype.valueOf()` навмисно зроблена непридатною: вона повертає об'єкт, тож повернене нею значення ніколи не буде використано жодним [алгоритмом зведення до примітива](/uk/docs/Web/JavaScript/Data_structures#zvedennia-typiv). Чимало вбудованих об'єктів перевизначає цей метод, аби повертати відповідне примітивне значення. При створенні власного об'єкта можна перевизначити `valueOf()`, аби викликався власний метод, щоб такий власний об'єкт міг бути перетворений на примітивне значення. Загалом, `valueOf()` використовується для повертання значення, що є найсуттєвішим в об'єкті – на відміну від `toString()`, це не обов'язково повинен бути рядок. Інший варіант: можна додати метод [`@@toPrimitive`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toPrimitive), котрий дає змогу іще краще контролювати процес перетворення; такий об'єкт завжди матиме пріоритет над `valueOf` і `toString`, при будь-якому перетворенні типів.
Усі об'єкти, що успадковують від `Object.prototype` (тобто всі, крім [`null`-прототипних об'єктів](/uk/docs/Web/JavaScript/Reference/Global_Objects/Object#null-prototypni-obiekty)), успадковують метод `toString()`. Базова реалізація `Object.prototype.valueOf()` навмисно зроблена непридатною: вона повертає об'єкт, тож повернене нею значення ніколи не буде використано жодним [алгоритмом зведення до примітива](/uk/docs/Web/JavaScript/Data_structures#zvedennia-typiv). Чимало вбудованих об'єктів перевизначає цей метод, аби повертати відповідне примітивне значення. При створенні власного об'єкта можна перевизначити `valueOf()`, аби викликався власний метод, щоб такий власний об'єкт міг бути перетворений на примітивне значення. Загалом, `valueOf()` використовується для повертання значення, що є найсуттєвішим в об'єкті – на відміну від `toString()`, це не обов'язково повинен бути рядок. Інший варіант: можна додати метод [`[Symbol.toPrimitive]()`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toPrimitive), котрий дає змогу іще краще контролювати процес перетворення; такий об'єкт завжди матиме пріоритет над `valueOf` і `toString`, при будь-якому перетворенні типів.

## Приклади

Expand Down Expand Up @@ -83,7 +83,7 @@ box.valueOf();

### Застосування до об'єктів унарного плюса

[Унарний плюс](/uk/docs/Web/JavaScript/Reference/Operators/Unary_plus) виконує над своїм операндом [зведення до числового значення](/uk/docs/Web/JavaScript/Reference/Global_Objects/Number#zvedennia-do-chysla), що для більшості об'єктів без [`@@toPrimitive`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toPrimitive) означає виклик їхніх методів `valueOf()`. Проте якщо об'єкт не має власного методу `valueOf()`, то базова реалізація призведе до ігнорування `valueOf()`, і натомість використовуватиметься повернене значення `toString()`.
[Унарний плюс](/uk/docs/Web/JavaScript/Reference/Operators/Unary_plus) виконує над своїм операндом [зведення до числового значення](/uk/docs/Web/JavaScript/Reference/Global_Objects/Number#zvedennia-do-chysla), що для більшості об'єктів без [`[Symbol.toPrimitive]()`](/uk/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toPrimitive) означає виклик їхніх методів `valueOf()`. Проте якщо об'єкт не має власного методу `valueOf()`, то базова реалізація призведе до ігнорування `valueOf()`, і натомість використовуватиметься повернене значення `toString()`.

```js
+new Date(); // Поточна мітка часу; те саме, що й new Date().getTime()
Expand Down
Loading