Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Math.sign: sinal numérico

Math.sign converte o argumento para Number e devolve -1, +1, o zero correspondente ou NaN conforme o sinal.

Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxe

Math.sign(x)

Math.sign(x) aplica ToNumber. Devolve -1 para um valor negativo não zero e +1 para um positivo não zero, incluindo -Infinity e Infinity. Para NaN, +0 e -0, devolve o próprio argumento, preservando o sinal do zero.

A apresentação normal mostra frequentemente ambos os zeros como 0; deteta zero negativo com Object.is(Math.sign(x), -0) ou o recíproco. A ausência de argumento converte undefined em NaN. Uma string numérica é convertida, enquanto Symbol ou BigInt lança TypeError; um objeto pode executar conversão.

A função é padrão desde ECMAScript 2015 e não é construtor. Serve para direção, comparação normalizada e ramificação, mas descarta magnitude. Não trates o resultado como Boolean simples: -1 e +1 são truthy, ambos os zeros e NaN são falsy.

Exemplos

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); }

Resultado

-1,0,1,1,-1
true -1
true true
true

Math.sign → -1, 0, +1 and preserved -0

Fontes