Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Math.sign: znak liczby

Math.sign konwertuje argument do Number i zwraca -1, +1, odpowiednie zero albo NaN zależnie od jego znaku.

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

Składnia

Math.sign(x)

Math.sign(x) stosuje ToNumber. Dla ujemnej niezerowej wartości zwraca -1, a dla dodatniej niezerowej +1; dotyczy to również -Infinity i Infinity. Dla NaN, +0 i -0 zwraca sam argument, więc znak zera zostaje zachowany.

Zwykłe wyświetlanie obu zer często daje tekst 0; do rozpoznania -0 użyj Object.is(Math.sign(x), -0) albo sprawdź odwrotność. Brak argumentu przechodzi z undefined do NaN. Łańcuch liczbowy jest konwertowany, natomiast Symbol i BigInt powodują TypeError; obiekt może uruchomić kod konwersji.

Funkcja jest standardowa od ECMAScript 2015 i nie jest konstruktorem. Przydaje się do kierunku zmiany, normalizacji porównania i rozgałęzień, ale usuwa informację o wielkości. Nie używaj wyniku jako prostego Boolean: -1 i +1 są truthy, natomiast oba zera są falsy, a NaN także jest falsy.

Przykłady

console.log([-7, 0, 9, Infinity, -Infinity].map(Math.sign).join(","));
console.log(Object.is(Math.sign(-0), -0), Math.sign("-12"));
console.log(Number.isNaN(Math.sign()), Number.isNaN(Math.sign(NaN)));
try { Math.sign(3n); } catch (error) { console.log(error instanceof TypeError); }

Wynik

-1,0,1,1,-1
true -1
true true
true

Math.sign → -1, 0, +1 and preserved -0

Źródła