Spec-Zone.ru › JavaScript

String.prototype.concat()

Базовая поддержка Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и в различных версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

Метод concat() значений String объединяет строковые аргументы с данной строкой и возвращает новую строку.

Попробовать

const str1 = "Hello";
const str2 = "World";

console.log(str1.concat(" ", str2));
// Expected output: "Hello World"

console.log(str2.concat(", ", str1));
// Expected output: "World, Hello"

Синтаксис

concat(str1)
concat(str1, str2)
concat(str1, str2, /* …, */ strN)

Параметры

str1, …, strN
Одна или несколько строк для объединения с str. Хотя технически это разрешено, вызов String.prototype.concat() без аргументов является бесполезной операцией, поскольку он не приводит к видимому копированию (как Array.prototype.concat()), поскольку строки являются неизменяемыми. Это должно происходить только в том случае, если вы распространяете массив строк в качестве аргументов, и этот массив оказывается пустым.

Возвращаемое значение

Новая строка, содержащая объединенный текст предоставленных строк.

Описание

Функция concat() объединяет строковые аргументы с вызывающей строкой и возвращает новую строку.

Если аргументы не являются типом "строка", они преобразуются в строковые значения перед объединением.

Метод concat() очень похож на операторы сложения/конкатенации строк (+, +=), за исключением того, что concat() приводит свои аргументы непосредственно к строкам, тогда как сложение сначала приводит свои операнды к примитивам. Для получения дополнительной информации см. справочную страницу для оператора +.

Примеры

Использование concat()

Следующий пример объединяет строки в новую строку.

const hello = "Hello, ";
console.log(hello.concat("Kevin", ". Have a nice day."));
// Hello, Kevin. Have a nice day.

const greetList = ["Hello", " ", "Venkat", "!"];
"".concat(...greetList); // "Hello Venkat!"

"".concat({}); // "[object Object]"
"".concat([]); // ""
"".concat(null); // "null"
"".concat(true); // "true"
"".concat(4, 5); // "45"

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

Спецификация
ECMAScript® 2027 Language Specification
# sec-string.prototype.concat

Совместимость с браузерами

Десктопные Мобильные Серверные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet WebView Android WebView on iOS Bun Deno Node.js
concat
1
12
1
4
1
18
4
10.1
1
1.0
4.4
1
1.0.0
1.0
0.10.0

Смотрите также

  • Array.prototype.concat()
  • Сложение (+)

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/concat

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API