Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources