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