String.prototype.concat()
O método concat()
combina o texto de duas ou mais strings e retorna uma nova string.
Sintaxe
str.concat(string2 [, ...stringN])
Parâmetros
string2...stringN
- Strings para concatenar à
string2
.
Valor retornado
Uma nova string contendo a string original concatenada à string passada como parâmetro.
Descrição
A função concat()
combina o texto de duas ou mais strings e retorna uma nova string. As alterações de texto de uma string não afetam a outra string.
Se o argumento passado não for do tipo string, o mesmo será convertido em uma string antes de ser concatenado.
Performance
É extremamente recomendado o uso dos operadores de atribuição (+
, +=
) em detrimento do método concat()
.
Exemplos
Usando concat()
O exemplo a seguir concatena uma string à outra string originando uma terceira string.
var hello = 'Olá, ';
console.log(hello.concat('Kevin', ' tenha um bom dia.'));
// retorna 'Olá, Kevin tenha um bom dia.'
Especificações
Especificação | Status | Comentários |
---|---|---|
ECMAScript 3rd Edition (ECMA-262) | Padrão | Definição inicial. Implementado no JavaScript 1.2. |
ECMAScript 5.1 (ECMA-262) The definition of 'String.prototype.concat' in that specification. |
Padrão | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'String.prototype.concat' in that specification. |
Padrão |
Navegadores compatíveis
Estamos convertendo nossos dados de compatibilidade para o formato JSON.
Esta tabela de compatibilidade ainda usa o formato antigo,
pois ainda não convertemos os dados que ela contém.
Descubra como você pode ajudar! (en-US)
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Suporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Característica | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Suporte básico | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |