Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Math.abs: wartość bezwzględna

Math.abs konwertuje argument na Number i zwraca jego nieujemną wartość bezwzględną, ze specjalną obsługą zera, NaN i nieskończoności.

Wersja: ECMAScript 1 onward; example target: Node.js 24.22.2

Składnia

Math.abs(x)

Math.abs(x) stosuje ToNumber do x, a następnie zwraca wielkość liczby bez znaku. Dla skończonej wartości ujemnej wynik jest dodatni, wartość dodatnia pozostaje bez zmian, a zarówno -0, jak i +0 dają +0. -Infinity daje Infinity, natomiast NaN pozostaje NaN.

Konwersja ma znaczenie: Math.abs("-3.5") daje 3.5, Math.abs(null) daje 0, a brak argumentu oznacza undefined i wynik NaN. Obiekt może uruchomić własne valueOf lub toString, więc konwersja może mieć skutki uboczne albo rzucić wyjątek. Symbol i BigInt nie mogą przejść ToNumber i powodują TypeError.

Funkcja nie jest konstruktorem i jest standardowa od ECMAScript 1. Nadaje się do odległości od zera lub bezwzględnej różnicy Math.abs(a - b), ale nie służy do obliczania długości wielowymiarowej — do tego użyj Math.hypot. Wynik nadal jest Number i podlega ograniczeniom precyzji IEEE 754.

Przykłady

console.log(Math.abs(-12.5), Math.abs("-3"), Math.abs(null));
console.log(Object.is(Math.abs(-0), 0), Math.abs(-Infinity));
console.log(Number.isNaN(Math.abs()), Number.isNaN(Math.abs("not-number")));
const reading = { valueOf() { return -9; } };
console.log(Math.abs(reading));
try { Math.abs(1n); } catch (error) { console.log(error instanceof TypeError); }

Wynik

12.5 3 0
true Infinity
true true
9
true

Źródła