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

CKTIS / JavaScript

Operador de decremento (--)

O operador -- subtrai um e volta a guardar o resultado no operando. A forma x-- devolve o valor numérico anterior, enquanto --x devolve o novo valor. Ambas suportam Number e BigInt.

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

x--
--x

O operador -- lê o operando, converte o seu valor num tipo numérico, subtrai um e volta a guardar o resultado. Subtrai 1 para Number e 1n para BigInt.

A forma pós-fixa x-- devolve o valor numérico anterior à alteração; a forma pré-fixa --x devolve o novo valor. Em ambos os casos, o resultado é guardado durante a avaliação da expressão, não na linha seguinte. Como instruções autónomas, têm o mesmo efeito.

O operando tem de ser um destino de atribuição válido, como uma variável ou uma propriedade de um objeto. 3-- é um erro de sintaxe, e tentar alterar uma variável const provoca um TypeError. Não é permitida uma quebra de linha entre o operando e o -- pós-fixo.

A conversão pode alterar o tipo: se x contiver "3", depois de x-- contém o número 2, e a expressão devolve o número 3. Number tem limites de precisão: subtrair um nem sempre altera um valor muito grande. Evita alterar a mesma variável várias vezes numa expressão.

Exemplos

let count = 3;
const previous = count--;
console.log(previous, count);
const current = --count;
console.log(current, count);

let big = 3n;
big--;
console.log(String(big));

Resultado

3 2
1 1
2

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