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

Метод unshift() додає один або декілька елементів на початок масиву і повертає новий розмір масиву.

+ +

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

+ +

Синтаксис

+ +
arr.unshift([element1[, ...[, elementN]]])
+ +

Параметри

+ +
+
elementN
+
Елементи для додавання в початок масиву.
+
+ +

Результат

+ +

Нова властивість {{jsxref("Array.length", "length")}} об'єкту, для якого було викликано функцію.

+ +

Опис

+ +

Метод unshift вставляє задані значення в початок масиву.

+ + + +

Метод unshift є навмисно загальним; він може бути {{jsxref("Function.call", "викликаний", "", 1)}} або {{jsxref("Function.apply", "застосований", "", 1)}} у об'єктах, схожих на масиви. Об'єкти, які не мають властивості length, що відображає останню з серії послідовних числових властивостей, що починаються з нуля, можуть поводитися непередбачувано.

+ +

Будь ласка, зауважте, якщо у параметри передається більше одного значення, вони всі вставляються на початку об'єкта, саме в тому порядку, в якому були передані у параметри. Отже, виклик unshift з n аргументів за один раз, або виклик n разів з 1 аргументом (наприклад, у циклі), не дадуть однаковий результат. Наприклад:

+ +
let arr = [4, 5, 6];
+
+arr.unshift(1, 2, 3);
+console.log(arr);
+// [1, 2, 3, 4, 5, 6]
+
+arr = [4, 5, 6]; // скидаємо значення масиву
+
+arr.unshift(1);
+arr.unshift(2);
+arr.unshift(3);
+
+console.log(arr);
+// [3, 2, 1, 4, 5, 6]
+ + + +

Приклади

+ +
var arr = [1, 2];
+
+arr.unshift(0); // результатом виклику буде значення 3, нова довжина масиву
+// arr дорівнює [0, 1, 2]
+
+arr.unshift(-2, -1); // нова довжина масиву дорівнює 5
+// arr дорівнює [-2, -1, 0, 1, 2]
+
+arr.unshift([-4, -3]); // нова довжина масиву дорівнює 6
+// arr дорівнбє [[-4, -3], -2, -1, 0, 1, 2]
+
+arr.unshift([-7, -6], [-5]); // нова довжина масиву дорівнює 8
+// arr дорівнює [ [-7, -6], [-5], [-4, -3], -2, -1, 0, 1, 2 ]
+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Назва специфікаціїСтатусКоментарій
{{SpecName('ES3')}}{{Spec2('ES3')}}Початкове визначення. Реалізовано в JavaScript 1.2.
{{SpecName('ES5.1', '#sec-15.4.4.13', 'Array.prototype.unshift')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-array.prototype.unshift', 'Array.prototype.unshift')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-array.prototype.unshift', 'Array.prototype.unshift')}}{{Spec2('ESDraft')}}
+ +

Сумісність з веб-переглядачами

+ + + +

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

+ +
+ +

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

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