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

CKTIS / JavaScript

Atribuição com subtração (-=)

O operador -= subtrai o operando direito ao valor atual do operando esquerdo e guarda o resultado na mesma localização. Efetua uma conversão numérica e a expressão completa devolve o valor atribuído.

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

target -= expression

O operador -= combina a subtração com a atribuição. Para uma variável simples, x -= y funciona como x = x - y, mas a expressão que identifica o operando esquerdo é avaliada apenas uma vez. Isto é importante ao aceder a uma propriedade ou a um elemento de um array com efeitos secundários.

Primeiro, determina-se a localização de armazenamento e lê-se o seu valor; em seguida, avalia-se o operando direito. À conversão numérica seguem-se a subtração e o armazenamento. O valor da expressão completa é o resultado da subtração.

Após a conversão, os dois operandos têm de ser valores Number ou ambos valores BigInt; misturar estes tipos gera um TypeError. Texto numérico como "12" pode ser convertido em Number. Ao contrário de +=, o operador -= não concatena cadeias de caracteres.

O operando esquerdo tem de ser um alvo de atribuição válido. Tentar alterar uma variável declarada com const gera um TypeError. No exemplo, remaining passa a ser o número 7, e result recebe o mesmo valor.

Exemplos

let remaining = "12";
const result = (remaining -= 5);
console.log(remaining);
console.log(result);
console.log(typeof remaining);

Resultado

7
7
number

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