diff options
Diffstat (limited to 'files/ru/web/javascript/reference/global_objects/array')
| -rw-r--r-- | files/ru/web/javascript/reference/global_objects/array/prototype/index.html | 171 |
1 files changed, 0 insertions, 171 deletions
diff --git a/files/ru/web/javascript/reference/global_objects/array/prototype/index.html b/files/ru/web/javascript/reference/global_objects/array/prototype/index.html deleted file mode 100644 index 4d04fc0736..0000000000 --- a/files/ru/web/javascript/reference/global_objects/array/prototype/index.html +++ /dev/null @@ -1,171 +0,0 @@ ---- -title: Array.prototype -slug: Web/JavaScript/Reference/Global_Objects/Array/prototype -tags: - - Array - - JavaScript - - Property - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Array/prototype ---- -<div>{{JSRef("Global_Objects", "Array")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> - -<p>Свойство <strong><code>Array.prototype</code></strong> представляет прототип для конструктора {{jsxref("Global_Objects/Array", "Array", "массива")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> - -<p>Экземпляры <span class="internal"><code>Array</code></span> наследуются от <code>Array.prototype</code>. Как и с остальными конструкторами, вы можете изменять прототип конструктора объекта для применения изменений ко всем экземплярам класса <code>Array</code>.</p> - -<p>Небольшой факт: <code>Array.prototype</code> сам является экземпляром <code>Array</code>:</p> - -<pre class="brush: js">Array.isArray(Array.prototype); // true</pre> - -<h2 id="Properties" name="Properties">Свойства</h2> - -<dl> - <dt><code>Array.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип объекта.</dd> - <dt>{{jsxref("Array.prototype.length")}}</dt> - <dd>Отражает количество элементов в массиве.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> - -<h3 id="Mutator_methods" name="Mutator_methods">Методы изменения</h3> - -<p>Эти методы изменяют массив:</p> - -<dl> - <dt>{{jsxref("Array.prototype.copyWithin()")}} {{experimental_inline}}</dt> - <dd>Копирует последовательность элементов массива внутри массива.</dd> - <dt>{{jsxref("Array.prototype.fill()")}} {{experimental_inline}}</dt> - <dd>Заполняет все элементы массива от начального индекса до конечного индекса указанным значением.</dd> - <dt>{{jsxref("Array.prototype.pop()")}}</dt> - <dd>Удаляет последний элемент из массива и возвращает его.</dd> - <dt>{{jsxref("Array.prototype.push()")}}</dt> - <dd>Добавляет один или более элементов в конец массива и возвращает новую длину массива.</dd> - <dt>{{jsxref("Array.prototype.reverse()")}}</dt> - <dd>Переворачивает порядок элементов в массиве — первый элемент становится последним, а последний — первым.</dd> - <dt>{{jsxref("Array.prototype.shift()")}}</dt> - <dd>Удаляет первый элемент из массива и возвращает его.</dd> - <dt>{{jsxref("Array.prototype.sort()")}}</dt> - <dd>Сортирует элементы массива на месте и возвращает отсортированный массив.</dd> - <dt>{{jsxref("Array.prototype.splice()")}}</dt> - <dd>Добавляет и/или удаляет элементы из массива.</dd> - <dt>{{jsxref("Array.prototype.unshift()")}}</dt> - <dd>Добавляет один или более элементов в начало массива и возвращает новую длину массива.</dd> -</dl> - -<h3 id="Accessor_methods" name="Accessor_methods">Методы доступа</h3> - -<p>Эти методы не изменяют массив, а просто возвращают его в ином представлении.</p> - -<dl> - <dt>{{jsxref("Array.prototype.concat()")}}</dt> - <dd>Возвращает новый массив, состоящий из данного массива, соединённого с другим массивом и/или значением (списком массивов/значений).</dd> - <dt>{{jsxref("Array.prototype.includes()")}} {{experimental_inline}}</dt> - <dd>Определяет, содержится ли в массиве указанный элемент, возвращая, соответственно, <code>true</code> или <code>false</code>.</dd> - <dt>{{jsxref("Array.prototype.join()")}}</dt> - <dd>Объединяет все элементы массива в строку.</dd> - <dt>{{jsxref("Array.prototype.slice()")}}</dt> - <dd>Извлекает диапазон значений и возвращает его в виде нового массива.</dd> - <dt>{{jsxref("Array.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает литеральное представление указанного массива; вы можете использовать это значение для создания нового массива. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.</dd> - <dt>{{jsxref("Array.prototype.toString()")}}</dt> - <dd>Возвращает строковое представление массива и его элементов. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.</dd> - <dt>{{jsxref("Array.prototype.toLocaleString()")}}</dt> - <dd>Возвращает локализованное строковое представление массива и его элементов. Переопределяет метод {{jsxref("Object.prototype.toLocaleString()")}}.</dd> - <dt>{{jsxref("Array.prototype.indexOf()")}}</dt> - <dd>Возвращает первый (наименьший) индекс элемента внутри массива, равный указанному значению; или -1, если значение не найдено.</dd> - <dt>{{jsxref("Array.prototype.lastIndexOf()")}}</dt> - <dd>Возвращает последний (наибольший) индекс элемента внутри массива, равный указанному значению; или -1, если значение не найдено.</dd> -</dl> - -<h3 id="Iteration_methods" name="Iteration_methods">Методы обхода</h3> - -<p>Некоторые методы принимают в качестве аргументов функции, вызываемые при обработке массива. Когда вызываются эти методы, достаётся длина массива, и любой элемент, добавленный свыше этой длины изнутри функции обратного вызова не посещается. Другие изменения в массиве (установка значения или удаление элемента) могут повлиять на результаты операции, если изменённый элемент метод посещает после изменения. Хотя специфическое поведение этих методов в таких случаях хорошо определено, вы не должны на него полагаться, чтобы не запутывать других людей, читающих ваш код. Если вам нужно изменить массив, лучше вместо этого скопируйте его в новый массив.</p> - -<dl> - <dt>{{jsxref("Array.prototype.forEach()")}}</dt> - <dd>Вызывает функцию для каждого элемента в массиве.</dd> - <dt>{{jsxref("Array.prototype.entries()")}} {{experimental_inline}}</dt> - <dd>Возвращает новый объект итератора массива <code>Array Iterator</code>, содержащий пары ключ / значение для каждого индекса в массиве.</dd> - <dt>{{jsxref("Array.prototype.every()")}}</dt> - <dd>Возвращает <code>true</code>, если каждый элемент в массиве удовлетворяет условию проверяющей функции.</dd> - <dt>{{jsxref("Array.prototype.some()")}}</dt> - <dd>Возвращает <code>true</code>, если хотя бы один элемент в массиве удовлетворяет условию проверяющей функции.</dd> - <dt>{{jsxref("Array.prototype.filter()")}}</dt> - <dd>Создаёт новый массив со всеми элементами этого массива, для которых функция фильтрации возвращает <code>true</code>.</dd> - <dt>{{jsxref("Array.prototype.find()")}} {{experimental_inline}}</dt> - <dd>Возвращает искомое значение в массиве, если элемент в массиве удовлетворяет условию проверяющей функции или {{jsxref("Global_Objects/undefined", "undefined")}}, если такое значение не найдено.</dd> - <dt>{{jsxref("Array.prototype.findIndex()")}} {{experimental_inline}}</dt> - <dd>Возвращает искомый индекс в массиве, если элемент в массиве удовлетворяет условию проверяющей функции или -1, если такое значение не найдено.</dd> - <dt>{{jsxref("Array.prototype.keys()")}} {{experimental_inline}}</dt> - <dd>Возвращает новый итератор массива, содержащий ключи каждого индекса в массиве.</dd> - <dt>{{jsxref("Array.prototype.map()")}}</dt> - <dd>Создаёт новый массив с результатами вызова указанной функции на каждом элементе данного массива.</dd> - <dt>{{jsxref("Array.prototype.reduce()")}}</dt> - <dd>Применяет функцию к аккумулятору и каждому значению массива (слева-направо), сводя его к одному значению.</dd> - <dt>{{jsxref("Array.prototype.reduceRight()")}}</dt> - <dd>Применяет функцию к аккумулятору и каждому значению массива (справа-налево), сводя его к одному значению.</dd> - <dt>{{jsxref("Array.prototype.values()")}} {{experimental_inline}}</dt> - <dd>Возвращает новый объект итератора массива <code>Array Iterator</code>, содержащий значения для каждого индекса в массиве.</dd> - <dt>{{jsxref("Array.prototype.@@iterator()", "Array.prototype[@@iterator]()")}} {{experimental_inline}}</dt> - <dd>Возвращает новый объект итератора массива <code>Array Iterator</code>, содержащий значения для каждого индекса в массиве.</dd> -</dl> - -<h3 id="Generic_methods" name="Generic_methods">Общие методы</h3> - -<p>Многие методы JavaScript-массива спроектированы таким образом, чтобы иметь возможность применяться ко всем объектам, «выглядящим похоже» на массивы. То есть, они могут использоваться на любом объекте, имеющим свойство <code>length</code> и к элементам которого можно получить доступ через числовые имена свойств (как при индексации: <code>array[5]</code>). <span class="comment">TODO: предоставить примеры с Array.prototype.forEach.call и добавлением методов к объекту, как сделано для {{jsxref("Global_Objects/JavaArray", "JavaArray")}} или {{jsxref("Global_Objects/String", "String")}}.</span> Некоторые методы, например {{jsxref("Array.join", "join")}}, только читают свойство <code>length</code> и числовые свойства объекта, на котором они вызываются. Другие, вроде {{jsxref("Array.reverse", "reverse")}} требуют, чтобы числовые свойства и свойство <code>length</code> объекта были изменяемыми; эти методы не могут вызываться на объектах вроде {{jsxref("Global_Objects/String", "String")}}, которые не позволяют установку своего свойства <code>length</code> или синтезирование числовых свойств.</p> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.4.3.1', 'Array.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-array.prototype', 'Array.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<p> </p> - -<div class="hidden"> -<p>The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> -</div> - -<p>{{Compat("javascript.builtins.Array.prototype")}}</p> - -<p> </p> - -<div> </div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li>{{jsxref("Global_Objects/Array", "Array")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> |