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