String.prototype.concat()

Метод concat() (зчепити) значень String приєднує рядкові аргументи до свого рядка, і повертає результат як новий рядок.

Спробуйте його в дії

Синтаксис

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

Параметри

str1, …, strN

Один чи більше рядків, які слід приєднати до початкового рядка str. Попри те, що технічно це дозволено, викликати String.prototype.concat() без аргументів – безглузда операція, тому що це не призводить до помітного копіювання (подібного до Array.prototype.concat()), адже рядки є незмінними значеннями. Таке повинно відбуватися лише тоді, коли відбувається розгортання масиву рядків як аргументів, і такий масив виявляється порожнім.

Повернене значення

Новий рядок, що містить всі передані рядки, з'єднані в один.

Опис

Функція concat() приєднує передані в аргументах рядки до рядка, на якому викликається, і повертає результат як новий рядок.

Якщо передані аргументи не є рядками, їх буде зведено до рядкового типу безпосередньо перед конкатенацією.

Метод concat вельми подібний до операторів додавання та зчеплення рядків (+, +=), за винятком того, що concat() зводить свої аргументи безпосередньо до рядків, натомість додавання перш за все зводить свої операнди до примітивів. Для отримання додаткової інформації дивіться довідкову сторінку оператора +.

Приклади

Застосування concat()

Наступний приклад поєднує два рядки в один новий.

const hello = "Привіт, ";
console.log(hello.concat("Кевіне", ". Гарного дня."));
// Привіт, Кевіне. Гарного дня.

const greetList = ["Привіт", " ", "Венкате", "!"];
"".concat(...greetList); // "Привіт Венкате!"

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

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

Сумісність із браузерами

Дивіться також

• Array.prototype.concat()
• Додавання (+)