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

CKTIS / JavaScript

O operador +: adição e concatenação

Em JavaScript, + soma números ou junta cadeias de caracteres. O resultado depende dos tipos dos valores, não do aspeto numérico dos caracteres.

Versão: ECMAScript 2020+

Sintaxe

left + right

O operador binário + começa por converter os dois operandos em valores primitivos. Se pelo menos um for uma cadeia de caracteres, efetua uma concatenação: converte o outro em texto e junta as cadeias. Caso contrário, efetua uma conversão numérica e uma adição.

2 + 3 produz o número 5, enquanto "2" + 3 produz a cadeia "23". Os parênteses agrupam operações, mas não alteram o tipo por si só. input.value devolve uma cadeia de caracteres, mesmo num campo com type="number".

Converte e valida explicitamente os dados antes de calcular uma soma. Number("2") + Number("3") dá 5. Contudo, Number converte uma cadeia vazia ou composta apenas por espaços em 0; texto não numérico produz NaN. Verifica separadamente os campos vazios e o intervalo permitido.

O operador é associativo à esquerda: 1 + 2 + "3" dá "33", enquanto "1" + 2 + 3 dá "123". Cada operação usa o tipo do resultado anterior. É um comportamento definido, não um erro do compilador.

Podes somar dois valores BigInt, mas 2n + 3 lança um TypeError. Somar um valor Symbol também provoca um erro. Os objetos podem personalizar a conversão através de Symbol.toPrimitive ou valueOf; + não chama sempre toString.

Esta entrada descreve o operador binário. O operador unário +valor é uma conversão numérica distinta. Nos exemplos, o tipo do resultado é tão importante como o valor apresentado.

Exemplos

const a = 2 + 3;
const b = "2" + 3;
console.log(a, typeof a);
console.log(b, typeof b);

Resultado

5 number
23 string
console.log(Number("2") + Number("3"));
console.log(Number(""));
console.log(Number.isNaN(Number("two")));

Resultado

5
0
true
console.log(1 + 2 + "3");
console.log("1" + 2 + 3);

Resultado

33
123
console.log((2n + 3n).toString());
try {
  console.log(2n + 3);
} catch (error) {
  console.log(error.name);
}

Resultado

5
TypeError

Fontes