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

CKTIS / JavaScript

String.prototype.concat — juntar cadeias de caracteres

String.prototype.concat acrescenta qualquer número de argumentos a uma cadeia de caracteres, convertendo-os em texto. Devolve um valor primitivo do tipo string e não altera a cadeia original.

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

str.concat(...args)

String.prototype.concat junta a cadeia de caracteres do recetor a zero ou mais argumentos, pela ordem fornecida. Não insere separadores: os espaços e os sinais de pontuação têm de ser indicados explicitamente. O resultado é um valor primitivo do tipo string, não um objeto String.

As cadeias de caracteres são imutáveis: o método não altera o valor original. Atribua o resultado a uma variável para o guardar. Uma chamada sem argumentos devolve o texto do recetor sem alterações.

O recetor é convertido primeiro em texto, seguindo-se os argumentos da esquerda para a direita, através de ToString. Os argumentos null e undefined produzem, respetivamente, "null" e "undefined"; um argumento do tipo symbol lança um TypeError. A conversão de objetos pode executar código personalizado e lançar uma exceção.

O método é genérico: String.prototype.concat.call(42, "!") devolve "42!". No entanto, usar null ou undefined como recetor causa um TypeError. Este é um método do padrão ECMAScript, não uma API do navegador.

Exemplos

const base = "Level";
const result = base.concat(" ", 3, "!");
console.log(result);
console.log(base);
console.log(base.concat() === base);

Resultado

Level 3!
Level
true

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