JavaScript метод String.prototype.concat()

Определение и применение

JavaScript метод concat() используется для объединения двух, или более строк в одну, при этом метод не изменяет существующие строки, а возвращает новую строку. Если какие-либо аргументы не являются строками, то перед объединением они преобразуются в строки.

Обращаю Ваше внимание, что для строковых аргументов метод concat() эквивалентен операции конкатенации строк:

JavaScript
var newString = string1 + string2 + ... + stringX;

Без аргументов возвращается исходное строковое значение. Объекты преобразуются в строки; это может отличаться от преобразования оператором +, который использует другую подсказку типа. Преобразование аргумента-символа вызывает TypeError.

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.String.concat
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
concat✓1✓12✓1✓4✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
// объединение двух строк
var newString = string1.concat(string2);

// объединение более двух строк
var newString = string1.concat(string2, string3, ..., stringX);

Спецификация

ECMAScript: String.prototype.concat()

Значения параметров

String: справочные сведения
Параметр Описание
string2, string3, ..., stringX Строковое значение, или значения, которые будут объединены с указанной строкой.

Примеры, попробуйте сами

В примере «Объединение нескольких строк» показан результат вызова метода.

Объединение нескольких строк

Измените исходную строку или аргумент метода и сравните результат после запуска.

index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <title>Объединение нескольких строк</title>
  </head>
  <body>
    <p>Результат выполнения выводится в консоль.</p>
  </body>
</html>
main.js
JavaScript
var string1 = 'Hello', // инициализируем переменные, содержащие строки
    string2 = ' World',
    string3 = '!!!'

var newString1 = string1.concat(string2) // переменная содержит значение Hello World
var newString2 = string1.concat(string2, string3) // переменная содержит значение Hello World!!!
console.log(newString2)