CKTIS / JavaScript
Math.sign: numeriek teken
Math.sign converteert het argument naar Number en geeft -1, +1, de overeenkomstige nul of NaN volgens het teken.
Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Math.sign(x)Math.sign(x) past ToNumber toe. Het retourneert -1 voor een negatieve niet-nulwaarde en +1 voor een positieve niet-nulwaarde, inclusief -Infinity en Infinity. Voor NaN, +0 en -0 retourneert het het argument zelf, zodat het nulteken behouden blijft.
Gewone weergave toont beide nullen vaak als 0; detecteer negatieve nul met Object.is(Math.sign(x), -0) of een omgekeerde waarde. Een ontbrekend argument converteert undefined naar NaN. Een numerieke tekenreeks wordt geconverteerd, terwijl Symbol of BigInt TypeError werpt; een object kan conversiecode uitvoeren.
De functie is standaard sinds ECMAScript 2015 en geen constructor. Ze helpt bij richting, genormaliseerde vergelijking en vertakking, maar verliest grootte. Gebruik het resultaat niet als simpele Boolean: -1 en +1 zijn truthy, beide nullen en NaN falsy.
Voorbeelden
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); }Resultaat
-1,0,1,1,-1 true -1 true true true
Math.sign → -1, 0, +1 and preserved -0