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

CKTIS / JavaScript

Menos unário

O menos unário (`unary minus`), escrito como `-expression`, converte o operando num valor numérico e devolve a sua negação. Suporta tanto `Number` como `BigInt`; não atribui o resultado novamente à variável.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

-expression

O operador unary minus escreve-se -expression. Tem um operando, ao contrário da subtração a - b, que tem dois. Devolve o valor oposto: -7 produz um número negativo, enquanto -(-7) produz um positivo. Em -value, o operador não atribui o resultado à variável value, mas, se value contiver um objeto, o código executado durante a conversão pode atribuir outro valor à variável.

A conversão ToNumeric ocorre primeiro. Um Number continua a ser Number, e um BigInt continua a ser BigInt: -12n produz -12n. A cadeia "12" é convertida num número, pelo que -"12" produz -12. A cadeia "hello" produz NaN, enquanto um operando do tipo Symbol causa um TypeError. A conversão de um objeto pode executar o seu próprio código e lançar uma exceção.

Para Number, o operador transforma +0 em -0 e vice-versa; negar NaN continua a produzir NaN. O zero negativo é importante: 1 / -0 produz -Infinity. BigInt não tem um zero negativo distinto, por isso -0n produz 0n.

O exemplo demonstra a negação sem atribuição, a conversão de cadeias, o tratamento de BigInt, o zero negativo e NaN. A chamada String(-12n) torna uniforme a apresentação do resultado BigInt.

Exemplos

const value = 7;
console.log(-value);
console.log(value);
console.log(-"12");
console.log(String(-12n));
console.log(1 / -0);
console.log(Number.isNaN(-"hello"));

Resultado

-7
7
-12
-12
-Infinity
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes