CKTIS / JavaScript
Math.sign : signe numérique
Math.sign convertit son argument en Number et renvoie -1, +1, le zéro correspondant ou NaN selon son signe.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
Math.sign(x)Math.sign(x) applique ToNumber. Il renvoie -1 pour une valeur négative non nulle et +1 pour une valeur positive non nulle, y compris -Infinity et Infinity. Pour NaN, +0 et -0, il renvoie l’argument même, préservant le signe du zéro.
L’affichage ordinaire montre souvent les deux zéros comme 0 ; détectez le zéro négatif avec Object.is(Math.sign(x), -0) ou l’inverse. Un argument absent convertit undefined en NaN. Une chaîne numérique est convertie, tandis que Symbol ou BigInt lève TypeError ; un objet peut exécuter sa conversion.
La fonction est standard depuis ECMAScript 2015 et n’est pas un constructeur. Utile pour direction, comparaison normalisée et branchement, elle perd la magnitude. Ne traitez pas le résultat comme simple booléen : -1 et +1 sont truthy, les zéros et NaN falsy.
Exemples
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); }Résultat
-1,0,1,1,-1 true -1 true true true
Math.sign → -1, 0, +1 and preserved -0