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

CKTIS / JavaScript

Atribuição com adição (+=)

O operador += efetua uma adição numérica ou concatena cadeias de caracteres e tenta escrever o resultado no destino da atribuição, que avalia apenas uma vez. Se a escrita não lançar uma exceção, a expressão tem o valor calculado, mesmo que a escrita seja ignorada.

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

target += expression lê o valor atual do destino, avalia o operando do lado direito, aplica as regras de + e tenta escrever o resultado nesse mesmo destino. Se a escrita não lançar uma exceção, o valor de toda a expressão é o resultado calculado. Fora do modo estrito, uma tentativa de escrita numa propriedade que não permite escrita pode ser ignorada sem lançar uma exceção: a propriedade mantém-se inalterada, mas a expressão continua a ter o valor calculado. Em modo estrito, uma tentativa de escrita deste tipo lança um TypeError.

Para uma variável simples, é semelhante a target = target + expression, mas o destino é avaliado apenas uma vez. Isto é importante com propriedades, índices e efeitos secundários. O lado esquerdo tem de ser um destino de atribuição válido; atribuir a uma ligação const gera um TypeError.

Os operandos são primeiro convertidos em valores primitivos. Se pelo menos um desses valores for uma cadeia de caracteres, o operador tenta concatená-los como cadeias de caracteres. Se o outro valor for do tipo Symbol, a sua conversão implícita em cadeia de caracteres gera um TypeError. Se nenhum dos valores for uma cadeia de caracteres, o operador tenta converter ambos para efetuar uma adição numérica. Nesse caso, converter um valor do tipo Symbol gera um TypeError. Misturar Number e BigInt numa adição numérica também gera um TypeError. Assim, total += "3" pode transformar um número numa cadeia de caracteres. Os objetos podem executar código personalizado durante a conversão.

Exemplos

let total = 7;
const result = (total += 5);
console.log(total, result);

total += "3";
console.log(total, typeof total);

let count = 7n;
count += 5n;
console.log(String(count));

Resultado

12 12
123 string
12

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