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.