From 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:43:23 -0500 Subject: initial commit --- .../reference/global_objects/array/join/index.html | 114 +++++++++++++++++++++ 1 file changed, 114 insertions(+) create mode 100644 files/uk/web/javascript/reference/global_objects/array/join/index.html (limited to 'files/uk/web/javascript/reference/global_objects/array/join/index.html') diff --git a/files/uk/web/javascript/reference/global_objects/array/join/index.html b/files/uk/web/javascript/reference/global_objects/array/join/index.html new file mode 100644 index 0000000000..116fb03bec --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/array/join/index.html @@ -0,0 +1,114 @@ +--- +title: Array.prototype.join() +slug: Web/JavaScript/Reference/Global_Objects/Array/join +tags: + - Array + - JavaScript + - Method + - Prototype + - Масив + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Array/join +--- +
{{JSRef}}
+ +

Метод join() створює та повертає рядок, що об'єднує всі елементи масиву (або подібного до масиву об'єкта), розділені комами або заданим роздільником. Якщо масив містить лише один елемент, то він буде повернений без роздільника.

+ +
{{EmbedInteractiveExample("pages/js/array-join.html")}}
+ + + +

Синтаксис

+ +
arr.join([separator])
+ +

Параметри

+ +
+
separator {{optional_inline}}
+
Визначає рядок, що розділить кожну пару сусідніх елементів масиву. Роздільник перетворюється на рядок, якщо це необхідно. Якщо він пропущений, елементи масиву будуть розділені комою (","). Якщо separator є порожнім рядком, усі елементи будуть обʼєднані без жодних знаків між ними.
+
+ +

Вертає

+ +

Рядок з усіма обʼєднаними елементами масиву. Якщо arr.length дорівнює  0, буде повернений порожній рядок.

+ +

Опис

+ +

Рядкові представлення усіх елементів масиву поєднуються в один рядок.

+ +
+

Якщо елемент дорівнює undefined або null, він перетворюється на порожній рядок.

+
+ +

Приклади

+ +

Обʼєднання масиву різними шляхами

+ +

В наступному прикладі створюється масив a із трьома елементами, після чого поєднується чотири рази: використовуючи роздільник за замовчуванням, кому та пробіл, плюс, порожній рядок.

+ +
var a = ['Вітер', 'Вода', 'Вогонь'];
+a.join();      // 'Вітер,Вода,Вогонь'
+a.join(', ');  // 'Вітер, Вода, Вогонь'
+a.join(' + '); // 'Вітер + Вода + Вогонь'
+a.join('');    // 'ВітерВодаВогонь'
+ +

Обʼєднання подібного до масиву об'єкта

+ +

В наступному прикладі подібний до масиву об'єкт (arguments) об'єднується шляхом виклику {{jsxref("Function.prototype.call")}} для Array.prototype.join.

+ +
function f(a, b, c) {
+  var s = Array.prototype.join.call(arguments);
+  console.log(s); // '1,a,true'
+}
+f(1, 'a', true);
+//очікуваний результат: "1,a,true"
+
+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES1')}}{{Spec2('ES1')}}Початкове визначення. Запроваджено у JavaScript 1.1.
{{SpecName('ES5.1', '#sec-15.4.4.5', 'Array.prototype.join')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-array.prototype.join', 'Array.prototype.join')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-array.prototype.join', 'Array.prototype.join')}}{{Spec2('ESDraft')}}
+ +

Підтримка веб-переглядачами

+ +
+ + +

{{Compat("javascript.builtins.Array.join")}}

+
+ +

Див. також

+ + -- cgit v1.2.3-54-g00ecf