CKTIS / JavaScript
Math.sign: numerisches Vorzeichen
Math.sign wandelt das Argument in Number um und liefert je nach Vorzeichen -1, +1, die entsprechende Null oder NaN.
Version: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Math.sign(x)Math.sign(x) wendet ToNumber an. Für einen negativen Wert ungleich null liefert es -1, für einen positiven +1; das gilt auch für -Infinity und Infinity. Bei NaN, +0 und -0 wird das Argument selbst zurückgegeben, das Nullvorzeichen bleibt also erhalten.
Normale Ausgabe zeigt beide Nullwerte oft als 0; negative Null erkennt Object.is(Math.sign(x), -0) oder der Kehrwert. Ein fehlendes Argument wird von undefined zu NaN. Numerische Zeichenketten werden umgewandelt, Symbol oder BigInt löst TypeError aus; ein Objekt kann Umwandlungscode ausführen.
Die Funktion ist seit ECMAScript 2015 Standard und kein Konstruktor. Sie dient für Richtung, normalisierte Vergleiche und Verzweigungen, verwirft aber den Betrag. Ergebnis nicht einfach als Boolean verwenden: -1 und +1 sind truthy, beide Nullwerte und NaN falsy.
Beispiele
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); }Ergebnis
-1,0,1,1,-1 true -1 true true true
Math.sign → -1, 0, +1 and preserved -0