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

CKTIS / JavaScript

Operador de subtração (-)

O operador binário `-` subtrai o operando da direita ao da esquerda. Converte os operandos em valores numéricos e aceita `Number` ou `BigInt`, mas não permite misturar estes tipos.

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

left - right

A expressão left - right devolve a diferença: o operando da direita é subtraído ao da esquerda. A subtração binária é diferente de -value unário, que inverte o sinal de um valor. A subtração, por si só, não atribui o resultado a nenhum dos operandos.

O operador converte os operandos usando ToNumeric. Dois valores Number produzem um valor Number, e dois valores BigInt produzem um valor BigInt. Misturar estes tipos, como em 10n - 3, lança um TypeError; é necessária uma conversão explícita. Ao contrário de +, - não concatena cadeias de caracteres: "10" - 3 produz 7, enquanto "hello" - 3 produz NaN.

A subtração é associativa à esquerda: 10 - 3 - 2 significa (10 - 3) - 2. A multiplicação tem maior precedência. Os cálculos com Number podem envolver arredondamentos de vírgula flutuante; BigInt permite subtrair números inteiros com exatidão.

Exemplos

console.log(10 - 3);
console.log("10" - 3);
console.log(String(10n - 3n));
console.log(Number.isNaN("hello" - 3));
try {
  console.log(10n - 3);
} catch (error) {
  console.log(error.name);
}

Resultado

7
7
7
true
TypeError

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