From c058fa0fb22dc40ef0225b21a97578cddd0aaffa Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 14:51:05 +0100 Subject: unslug ru: move --- .../ru/web/javascript/about_javascript/index.html | 60 ++ files/ru/web/javascript/guide/about/index.html | 159 ---- .../web/javascript/guide/introduction/index.html | 159 ++++ .../guide/ispolzovanie_promisov/index.html | 321 ------- .../guide/javascript_overview/index.html | 142 ---- .../guide/loops_and_iteration/index.html | 362 ++++++++ .../guide/predefined_core_objects/index.html | 923 --------------------- .../web/javascript/guide/using_promises/index.html | 321 +++++++ .../index.html" | 159 ---- .../index.html" | 68 -- .../index.html" | 362 -------- .../index.html | 356 -------- .../index.html" | 44 - files/ru/web/javascript/reference/about/index.html | 50 ++ .../reference/classes/class_fields/index.html | 350 -------- .../classes/private_class_fields/index.html | 205 +++++ .../classes/public_class_fields/index.html | 350 ++++++++ .../index.html" | 205 ----- .../reference/errors/var_hides_argument/index.html | 60 ++ .../index.html" | 60 -- .../functions/method_definitions/index.html | 191 +++++ .../index.html" | 191 ----- .../global_objects/array/prototype/index.html | 171 ---- .../asyncfunction/prototype/index.html | 55 -- .../global_objects/boolean/prototype/index.html | 113 --- .../global_objects/date/prototype/index.html | 229 ----- .../global_objects/error/prototype/index.html | 155 ---- .../global_objects/evalerror/prototype/index.html | 122 --- .../global_objects/function/prototype/index.html | 152 ---- .../generatorfunction/prototype/index.html | 59 -- .../internalerror/prototype/index.html | 100 --- .../intl/collator/prototype/index.html | 109 --- .../intl/datetimeformat/prototype/index.html | 109 --- .../intl/numberformat/prototype/index.html | 109 --- .../global_objects/map/prototype/index.html | 126 --- .../index.html" | 136 --- .../global_objects/number/prototype/index.html | 124 --- .../global_objects/object/prototype/index.html | 205 ----- .../global_objects/promise/prototype/index.html | 67 -- .../proxy/handler/deleteproperty/index.html | 131 --- .../global_objects/proxy/handler/index.html | 135 --- .../global_objects/proxy/handler/set/index.html | 179 ---- .../proxy/proxy/deleteproperty/index.html | 131 +++ .../global_objects/proxy/proxy/set/index.html | 179 ++++ .../global_objects/rangeerror/prototype/index.html | 123 --- .../referenceerror/prototype/index.html | 123 --- .../global_objects/regexp/prototype/index.html | 141 ---- .../global_objects/set/prototype/index.html | 81 -- .../global_objects/string/prototype/index.html | 230 ----- .../global_objects/string/trimend/index.html | 93 +++ .../global_objects/string/trimleft/index.html | 93 --- .../global_objects/string/trimright/index.html | 93 --- .../global_objects/string/trimstart/index.html | 93 +++ .../global_objects/symbol/prototype/index.html | 107 --- .../syntaxerror/prototype/index.html | 123 --- .../global_objects/typedarray/prototype/index.html | 129 --- .../global_objects/typeerror/prototype/index.html | 123 --- .../global_objects/urierror/prototype/index.html | 123 --- .../global_objects/weakmap/prototype/index.html | 75 -- .../global_objects/weakset/prototype/index.html | 142 ---- .../operators/arithmetic_operators/index.html | 291 ------- .../reference/operators/assignment/index.html | 66 ++ .../operators/assignment_operators/index.html | 431 ---------- .../operators/bitwise_operators/index.html | 626 -------------- .../reference/operators/comma_operator/index.html | 103 +++ .../operators/conditional_operator/index.html | 169 ++++ .../reference/operators/grouping/index.html | 91 ++ .../operators/pipeline_operator/index.html | 77 ++ .../index.html" | 91 -- .../index.html" | 77 -- .../index.html" | 300 ------- .../index.html" | 103 --- .../index.html" | 286 ------- .../index.html" | 66 -- .../index.html" | 169 ---- .../reference/statements/block/index.html | 177 ++++ .../reference/statements/default/index.html | 117 --- .../\320\261\320\273\320\276\320\272/index.html" | 177 ---- .../reference/template_literals/index.html | 243 ++++++ .../reference/template_strings/index.html | 243 ------ .../reference/\320\276\320\261/index.html" | 50 -- files/ru/web/javascript/shells/index.html | 44 + .../web/javascript/\320\276_javascript/index.html" | 60 -- 83 files changed, 3224 insertions(+), 10719 deletions(-) create mode 100644 files/ru/web/javascript/about_javascript/index.html delete mode 100644 files/ru/web/javascript/guide/about/index.html create mode 100644 files/ru/web/javascript/guide/introduction/index.html delete mode 100644 files/ru/web/javascript/guide/ispolzovanie_promisov/index.html delete mode 100644 files/ru/web/javascript/guide/javascript_overview/index.html create mode 100644 files/ru/web/javascript/guide/loops_and_iteration/index.html delete mode 100644 files/ru/web/javascript/guide/predefined_core_objects/index.html create mode 100644 files/ru/web/javascript/guide/using_promises/index.html delete mode 100644 "files/ru/web/javascript/guide/\320\262\320\262\320\265\320\264\320\265\320\275\320\270\320\265_\320\262_javascript/index.html" delete mode 100644 "files/ru/web/javascript/guide/\320\276\320\261_\321\215\321\202\320\276\320\274_\321\200\321\203\320\272\320\276\320\262\320\276\320\264\321\201\321\202\320\262\320\265/index.html" delete mode 100644 "files/ru/web/javascript/guide/\321\206\320\270\320\272\320\273\321\213_\320\270_\320\270\321\202\320\265\321\200\320\260\321\206\320\270\320\270/index.html" delete mode 100644 files/ru/web/javascript/introduction_to_object-oriented_javascript/index.html delete mode 100644 "files/ru/web/javascript/javascript_\321\210\320\265\320\273\320\273\321\213/index.html" create mode 100644 files/ru/web/javascript/reference/about/index.html delete mode 100644 files/ru/web/javascript/reference/classes/class_fields/index.html create mode 100644 files/ru/web/javascript/reference/classes/private_class_fields/index.html create mode 100644 files/ru/web/javascript/reference/classes/public_class_fields/index.html delete mode 100644 "files/ru/web/javascript/reference/classes/\320\277\321\200\320\270\320\262\320\260\321\202\320\275\321\213\320\265_\320\277\320\276\320\273\321\217_\320\272\320\273\320\260\321\201\321\201\320\260/index.html" create mode 100644 files/ru/web/javascript/reference/errors/var_hides_argument/index.html delete mode 100644 "files/ru/web/javascript/reference/errors/\320\277\320\265\321\200\320\265\320\274\320\265\320\275\320\275\321\213\320\265_\321\201\320\272\321\200\321\213\320\262\320\260\321\216\321\202_\320\260\321\200\320\263\321\203\320\274\320\265\320\275\321\202/index.html" create mode 100644 files/ru/web/javascript/reference/functions/method_definitions/index.html delete mode 100644 "files/ru/web/javascript/reference/functions/\320\276\320\277\321\200\320\265\320\264\320\265\320\273\320\270\320\275\320\270\320\265_\320\274\320\265\321\202\320\276\320\264\320\276\320\262/index.html" delete mode 100644 files/ru/web/javascript/reference/global_objects/array/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/asyncfunction/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/boolean/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/date/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/error/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/evalerror/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/function/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/generatorfunction/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/internalerror/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/intl/collator/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/intl/datetimeformat/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/intl/numberformat/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/map/prototype/index.html delete mode 100644 "files/ru/web/javascript/reference/global_objects/math/\320\274\320\265\321\202\320\276\320\264_math.max()_/index.html" delete mode 100644 files/ru/web/javascript/reference/global_objects/number/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/object/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/promise/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/proxy/handler/deleteproperty/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/proxy/handler/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/proxy/handler/set/index.html create mode 100644 files/ru/web/javascript/reference/global_objects/proxy/proxy/deleteproperty/index.html create mode 100644 files/ru/web/javascript/reference/global_objects/proxy/proxy/set/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/rangeerror/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/referenceerror/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/regexp/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/set/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/string/prototype/index.html create mode 100644 files/ru/web/javascript/reference/global_objects/string/trimend/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/string/trimleft/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/string/trimright/index.html create mode 100644 files/ru/web/javascript/reference/global_objects/string/trimstart/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/symbol/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/syntaxerror/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/typedarray/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/typeerror/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/urierror/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/weakmap/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/global_objects/weakset/prototype/index.html delete mode 100644 files/ru/web/javascript/reference/operators/arithmetic_operators/index.html create mode 100644 files/ru/web/javascript/reference/operators/assignment/index.html delete mode 100644 files/ru/web/javascript/reference/operators/assignment_operators/index.html delete mode 100644 files/ru/web/javascript/reference/operators/bitwise_operators/index.html create mode 100644 files/ru/web/javascript/reference/operators/comma_operator/index.html create mode 100644 files/ru/web/javascript/reference/operators/conditional_operator/index.html create mode 100644 files/ru/web/javascript/reference/operators/grouping/index.html create mode 100644 files/ru/web/javascript/reference/operators/pipeline_operator/index.html delete mode 100644 "files/ru/web/javascript/reference/operators/\320\263\321\200\321\203\320\277\320\277\320\270\321\200\320\276\320\262\320\272\320\260/index.html" delete mode 100644 "files/ru/web/javascript/reference/operators/\320\272\320\276\320\275\320\262\320\265\320\271\320\265\321\200\320\275\321\213\320\271_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200/index.html" delete mode 100644 "files/ru/web/javascript/reference/operators/\320\273\320\276\320\263\320\270\321\207\320\265\321\201\320\272\320\270\320\265_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200\321\213/index.html" delete mode 100644 "files/ru/web/javascript/reference/operators/\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200_\320\267\320\260\320\277\321\217\321\202\320\260\321\217/index.html" delete mode 100644 "files/ru/web/javascript/reference/operators/\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200\321\213_\321\201\321\200\320\260\320\262\320\275\320\265\320\275\320\270\321\217/index.html" delete mode 100644 "files/ru/web/javascript/reference/operators/\320\277\321\200\320\270\321\201\320\262\320\260\320\270\320\262\320\260\320\275\320\270\320\265/index.html" delete mode 100644 "files/ru/web/javascript/reference/operators/\321\203\321\201\320\273\320\276\320\262\320\275\321\213\320\271_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200/index.html" create mode 100644 files/ru/web/javascript/reference/statements/block/index.html delete mode 100644 files/ru/web/javascript/reference/statements/default/index.html delete mode 100644 "files/ru/web/javascript/reference/statements/\320\261\320\273\320\276\320\272/index.html" create mode 100644 files/ru/web/javascript/reference/template_literals/index.html delete mode 100644 files/ru/web/javascript/reference/template_strings/index.html delete mode 100644 "files/ru/web/javascript/reference/\320\276\320\261/index.html" create mode 100644 files/ru/web/javascript/shells/index.html delete mode 100644 "files/ru/web/javascript/\320\276_javascript/index.html" (limited to 'files/ru/web/javascript') diff --git a/files/ru/web/javascript/about_javascript/index.html b/files/ru/web/javascript/about_javascript/index.html new file mode 100644 index 0000000000..6d3682cf3a --- /dev/null +++ b/files/ru/web/javascript/about_javascript/index.html @@ -0,0 +1,60 @@ +--- +title: О JavaScript +slug: Web/JavaScript/О_JavaScript +tags: + - Beginner + - Introduction + - JavaScript + - Вступление + - Новичку +translation_of: Web/JavaScript/About_JavaScript +--- +

{{JsSidebar()}}

+ +

Что такое JavaScript?

+ +

JavaScript® (часто сокращают до JS) — это лёгкий, интерпретируемый, объектно-ориентированный язык с функциями первого класса, самый известный скриптовый язык для веб-страниц, но также используется во многих не браузерных окружениях. Прототипно-ориентированный, мультипарадигменный язык сценариев, который поддерживает динамический, объектно-ориентированный, императивный и функциональный стили программирования.

+ +

JavaScript запускается на стороне клиента Интернета, который может использоваться для создания/программирования того, как веб-страницы будут вести себя при наступлении каких-либо событий. JavaScript легко изучить, а также это мощный скриптовый язык, широко используемый для контролирования поведения веб-страниц.

+ +

Вопреки распространенному мнению, JavaScript не является "интерпретируемым Java". В двух словах, JavaScript — это динамический скриптовый язык, поддерживающий прототипное создание объектов. Базовый синтаксис намеренно похож на Java и C++, чтобы уменьшить число новых концепций, необходимых для изучения языка. Такие языковые конструкции, как if, for, while, switch, try ... catch похожи на конструкции этих языков.

+ +

JavaScript может функционировать и как процедурный, и как объектно-ориентированный язык. Объекты можно создавать программно во время выполнения, путем присоединения методов и свойств или пустых объектов во время выполнения, в отличие от синтаксических определений классов в компилируемых языках, таких как С++ или Java. После того, как объект был создан, он может быть использован в качестве плана (или прототипа) для создания похожих объектов.

+ +

Динамические возможности JavaScript включают: создание объектов во время выполнения, переменное число параметров, динамическое создание скриптов (с помощью eval), перебор объектов (с помощью for ... in), восстановление исходного кода (программы на JavaScript могут декомпилировать тела функций обратно в исходный код).

+ +

Для более глубокого погружения в программирование на JavaScript, используйте ссылки ниже в разделе Ресурсы по JavaScript.

+ +

Какие реализации JavaScript доступны?

+ +

Mozilla предоставляет две реализации JavaScript. Самая первая реализация JavaScript была создана Бренданом Эйхом (Brendan Eich) в компании Netscape, и с тех пор обновляется, чтобы соответствовать ECMA-262 Edition 5 и более поздним версиям. Этот движок называется SpiderMonkey и реализован на языке C/C++. Движок Rhino создан Норрисом Бойдом (Norris Boyd) и реализован на языке Java. Как и SpiderMonkey, Rhino соответствует ECMA-262 Edition 5.

+ +

Несколько оптимизаций, таких как TraceMonkey (Firefox 3.5), JägerMonkey (Firefox 4) и IonMonkey, добавили в SpiderMonkey со временем. Работа всегда продолжается, чтобы улучшить производительность выполнения JavaScript.

+ +

Кроме вышеприведенных существуют и другие популярные реализации:

+ + + +

Каждый движок mozilla.org предоставляет публичный API, который могут использовать разработчики приложений для интеграции JavaScript в своё ПО. Однако, наиболее распространенной средой для JavaScript являются веб-браузеры. Веб-браузеры обычно используют публичный API для создания объектов среды, отражающих DOM в JavaScript.

+ +

JavaScript также применяется как скриптовый язык на стороне сервера. JavaScript сервер предоставляет объекты среды, представляющие объекты HTTP запросов и ответов, которые могут быть использованы программой на JavaScript для динамической генерации веб-страниц. Популярным примером является Node.js.

+ +

Ресурсы по JavaScript

+ +
+
SpiderMonkey
+
SpiderMonkey — это интерпретатор языка JavaScript, написанный на языке C. Информация, относящаяся к реализации движка JavaScript Mozilla на C/C++ (aka SpiderMonkey), включая, как вставлять его в приложения.
+
Rhino
+
Информация, относящаяся к реализации JavaScript, написанной на Java (aka Rhino).
+
Ресурсы по языку
+
Ссылки на опубликованные стандарты по JavaScript.
+
Повторное введение в JavaScript
+
Руководство и справочник по JavaScript.
+
+ +

JavaScript® - торговая марка или зарегистрированная торговая марка Oracle в США и других странах.

diff --git a/files/ru/web/javascript/guide/about/index.html b/files/ru/web/javascript/guide/about/index.html deleted file mode 100644 index 6d58fafb80..0000000000 --- a/files/ru/web/javascript/guide/about/index.html +++ /dev/null @@ -1,159 +0,0 @@ ---- -title: Об этом учебнике -slug: Web/JavaScript/Guide/About -translation_of: Web/JavaScript/Guide/Introduction -translation_of_original: Web/JavaScript/Guide/About ---- -

JavaScript это кросс-платформенный, объектно-ориентированный интерпретируемый язык программирования. В этом учебнике описано все, что вам нужно знать для того, чтобы начать ипользовать JavaScript.

- -

Особенности разных версий JavaScript

- -

 

- - - -

 

- -

Что вы уже должны знать

- -

Этот учебник предполагает, что у вас уже имеются некоторые знания и опыт:

- -

Общее понимание, что такое Интернет и всемирная сеть WWW. Знание языка разметки гипертекста (HTML) также привествуется.

- -

Некоторый опыт программирования на C или Visual Basic будет полезен, но не является обязательным.

- -

Версии JavaScript

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Таблица 1. Версии JavaScript и Navigator
Версия JavaScriptВерсия Navigator
JavaScript 1.0Navigator 2.0
JavaScript 1.1Navigator 3.0
JavaScript 1.2Navigator 4.0-4.05
JavaScript 1.3Navigator 4.06-4.7x
JavaScript 1.4 
JavaScript 1.5Navigator 6.0
- Mozilla (браузер с открытым исходным кодом)
JavaScript 1.6Firefox 1.5, другие, основанные на Mozilla 1.8 продукты
JavaScript 1.7Firefox 2, другие, основанные на Mozilla 1.8.1 продукты
JavaScript 1.8Firefox 3, другие, основанные на Mozilla 1.9 продукты
- -

Каждая версия Netscape Enterprise Server также поддерживает разные версии JavaScript. Чтобы помочь вам писать скрипты совместимые с разными версиями Enterprise Server, это руководство пользуется аббревиатурой, которая однозначно идентифицирует версию сервера, в которой реализована каждая функциональность.

- -


-  Таблица 2. Аббревиатуры версий Netscape Enterprise Server

- - - - - - - - - - - - - - - - - - -
AbbreviationEnterprise Server version
NES 2.0Netscape Enterprise Server 2.0
NES 3.0Netscape Enterprise Server 3.0
- -

Где найти информацию по JavaScript

- -

Документация JavaScript включает в себя следующие материалы:

- - - -

Если вы новичок в JavaScript, то начните с Учебника JavaScript. Как только вы усвоили фундаментальные основы, вы можете начать пользоваться Справочником JavaScript, чтобы получить больше информации об определенных объектах, выражениях и операторах.

- -

Советы изучающим JavaScript

- -

Начать изучать JavaScript очень легко: все что вам нужно - это современный веб браузер. Этот учебник включает описание некоторых особенностей JavaScript, которые доступны только в самых последних версиях Firefox (и других браузерах основанных на движке Gecko), так что лучше всего воспользоваться самой последней версией Firefox.

- -

Интерактивный интерпретатор.

- -

Интерактивная строка ввода JavaScript окажет бесценную услугу в изучении языка, так как позволит пробовать все вещи сразу же, вам не потребуется сохранять изменения в файле и обновлять страницу каждый раз. Консоль ошибок Firefox, доступна через меню Инструменты, предлагает простой способ попробовать выполнить JavaScript выражения: просто введите строку с кодом и нажмите кнопку "Evaluate".

- -

Image:ErrorConsole.png

- -

Firebug

- -

Более продвинутое средство доступно в Firebug. Firebug это расширение Firefox. Хотя в последних версиях Firefox средства отладки становятся более совершенными и такой нужды Firebug уже нет. Выражения которые вы вводите интерпретируются как объекты и связываются c другими частями в Firebug. Например, вы можете сложить 5 плюс 5, заменить буквы в строке со строчных на прописные, получить кликабельную ссылку на документ, или получить ссылку на элемент в документе:

- -

- -

Нажав на кнопке со стрелкой в нижнем правом углу вы можете открыть многострочный редактор скриптов.

- -

Firebug также имеет в составе продвинутый инспектор DOM, дебаггер JavaScript, инструменты профилирования и многие другие полезные утилиты. JavaScript код выполняемый на веб странице может вызвать функцию console.log(), которая выведет свой аргумент на консоль Firebug.

- -

Множество примеров в этом учебнике используют функцию alert(), чтобы вывести сообщение во время выполнения скрипта.

- -

Принятые соглашения в документе

- -

JavaScript приложения выполняются на разных операционных системах; информация в этом учебнике актуальна в любом случае. Пути к директориям или файлам даны в формате Windows (обратный слеш как разделитель). Для версии Юникс, пути точно такие же, за исключением того, что используеся обычный слеш вместо обратного, а также соотвественно корневая директория начинается с '/' а не 'c:/' как это в Windows.

- -

Этот учебник использует единый локатор ресурсов (URL-ы) следующей формы:

- -

http://server.domain/path/file.html

- -

В этих URL-ах, server - это имя сервера на котором запущено ваше приложение, например research1 или www; domain - это имя Internet домена, например netscape.com или uiuc.edu; path - структура директорий на сервере; и file.html - имя файла, который расположен на вашем сервере. В общем, элементы выделенные курсивом в URL-ах это метки-заполнители, а элементы выделенные нормальным моноширинным шрифтом точные неизменные значения (например, конфиругацию сервера вы можете изменить, как и сменить доменное имя, структура каталогов может поменяться, а вот протокол всегда один, и расширение файла для  вебстраниц тоже постоянно). Если ваш вебсервер поддерживает Secure Sockets Layer (SSL), то вы можете пользоваться  https вместо http в URL.

- -

Этот учебник пользуется следующим соглашением об использовании шрифтов:

- - diff --git a/files/ru/web/javascript/guide/introduction/index.html b/files/ru/web/javascript/guide/introduction/index.html new file mode 100644 index 0000000000..1b49c45ddb --- /dev/null +++ b/files/ru/web/javascript/guide/introduction/index.html @@ -0,0 +1,159 @@ +--- +title: Введение в JavaScript +slug: Web/JavaScript/Guide/Введение_в_JavaScript +tags: + - Beginner + - Guide + - JavaScript +translation_of: Web/JavaScript/Guide/Introduction +--- +

{{jsSidebar("JavaScript Guide")}} {{PreviousNext("Web/JavaScript/Guide", "Web/JavaScript/Guide/Values,_variables,_and_literals")}}

+ +
+

Данная глава является введением в JavaScript и рассматривает некоторые его фундаментальные концепции.

+
+ +

Что вам уже следует знать?

+ +

В данном руководстве предполагается, что вы имеете:

+ + + +

Где можно найти информацию о JavaScript?

+ +

Документация по JavaScript на MDN включает:

+ + + +

Если вы являетесь новичком в JavaScript, то начните с Изучение Web и Руководство по JavaScript. Как только вы освоите фундаментальные концепции, используйте Справочник по JavaScript для того, чтобы получить более подробную информацию о конкретных объектах или операторах.

+ +

Что такое JavaScript?

+ +

JavaScript — это кросс-платформенный, объектно-ориентированный скриптовый язык, являющийся небольшим и легковесным. Внутри среды исполнения JavaScript может быть связан с объектами данной среды и предоставлять программный контроль над ними.

+ +

JavaScript включает стандартную библиотеку объектов, например, Array, Date и Math, а также базовый набор языковых элементов, например, операторы и управляющие конструкции. Ядро JavaScript может быть расширено для различных целей путем добавления в него новых объектов, например:

+ + + +

JavaScript и Java

+ +

JavaScript и Java похожи в одних отношениях, но фундаментально отличны в других. Javascript напоминает Java, но не имеет статической типизации и строгой проверки типов, которыми обладает Java. JavaScript следует большей части синтаксиса Java в выражениях, соглашениях об именовании и основного потока управления конструкциями, поэтому он был переименован из LiveScript в JavaScript.

+ +

В отличие от системы скомпилированных классов Java, построенной на объявлениях, JavaScript поддерживает систему исполнения, основанную на небольшом числе типов данных, представляющих числовые, логические и строковые значения. JavaScript имеет объектную модель на базе прототипов вместо более общей модели на базе классов. Модель объектов на базе прототипов предоставляет динамическое наследование, т.е. то, что наследуется, может отличаться для отдельных объектов. JavaScript также поддерживает функции без каких-либо специальных декларативных требований. Функции могут быть свойствами объектов, выполняться как свободно-типизированные методы.

+ +

По сравнению с Java, JavaScript является языком с очень свободной формой. Вам не надо объявлять переменные, классы и методы. Вам не надо беспокоиться о том, являются ли методы публичными (public), приватными (private) или защищенными (protected), а также вам не надо реализовывать интерфейсы. Переменные, параметры и возвращаемые функциями типы не являются явно типизированными.

+ +

Java — это язык программирования, основанный на классах и предназначенный для быстрого выполнения и безопасности типов. Безопасность типов означает, например, что вы не можете привести тип integer к типу object reference или получить доступ к приватной памяти, изменяя байт-код Java. Ориентированная на классы модель Java означает, что программы состоят исключительно из классов и их методов. Наследование классов и строгая типизация в Java обычно требуют тесно связанные иерархии объектов. Эти требования делают программирование на Java более комплексным, чем программирование на JavaScript.

+ +

По духу JavaScript происходит от небольших, динамически типизированных языков, таких как HyperTalk и dBASE. Эти скриптовые языки предлагают инструменты программирования для гораздо более широкой аудитории благодаря более простому синтаксису, специализированной встроенной функциональности и минимальным требованиям для создания объектов.

+ + + + + + + + + + + + + + + + + + + + + + + +
Сравнение JavaScript и Java
JavaScriptJava
Объектно-ориентированный. Нет различий между типами объектов. Наследование реализовано через механизм прототипов, свойства и методы могут быть добавлены в любой объект динамически.На базе классов. Объекты делятся на классы и экземпляры с наследованием через классовую иерархию. Классы и экземпляры не могут иметь динамически добавленные свойства или методы.
Типы данных переменных не объявляются (динамическая типизация).Типы данных переменных должны быть объявлены (статическая типизация).
Не может автоматически записывать на жесткий диск.Может автоматически записывать на жесткий диск.
+ +

Для получения дополнительной информации о различиях между JavaScript и Java, прочитайте Details of the object model.

+ +

JavaScript и спецификация ECMAScript

+ +

JavaScript стандартизирован европейской ассоциацией Ecma International, деятельность которой посвящена стандартизации информационных и коммуникационных систем (изначально ECMA являлся акронимом European Computer Manufacturers Association). Эта стандартизированная версия JavaScript, называемая ECMAScript, работает одинаково во всех приложениях, поддерживающих стандарт. Компании могут использовать открытый стандарт языка, чтобы разработать собственную реализацию JavaScript. Стандарт ECMAScript задокументирован в спецификации ECMA-262. Чтобы узнать больше информации о разных версиях JavaScript и ECMAScript, прочитайте Что нового в JavaScript.

+ +

Стандарт ECMA-262 также утвержден ISO (International Organization for Standardization) как ISO-16262. Вы можете найти спецификацию на сайте Ecma International. Спецификация ECMAScript не описывает Document Object Model (DOM), которая стандартизирована World Wide Web Consortium (W3C). DOM определяет способ для доступа к объектам HTML документа из вашего скрипта. Чтобы получить более точное представление о различных технологиях, используемых при программировании на JavaScript, прочитайте Обзор JavaScript.

+ +

Документация JavaScript против спецификации ECMAScript

+ +

Спецификация ECMAScript — это набор требований, касающихся реализации ECMAScript. Она предназначена для реализации языковых возможностей, соответствующих стандарту, в вашей реализации ECMAScript или движке (например, SpiderMonkey в Firefox или V8 в Google Chrome).

+ +

Документ ECMAScript не предназначен для помощи программистам в создании скриптов; чтобы получить информацию о том, как писать скрипты, используйте документацию JavaScript.

+ +

Спецификация ECMAScript использует терминологию и синтаксис, которые могут быть незнакомы JavaScript-программистам. Хотя описание языка может отличаться в ECMAScript, но сам язык остается таким же. JavaScript поддерживает всю функциональность, описанную в спецификации ECMAScript.

+ +

Документация JavaScript описывает аспекты языка, являющиеся подходящими для JavaScript-программиста.

+ +

Начинаем знакомство с JavaScript

+ +

Все, что вам нужно для знакомства с JavaScript — это современный браузер. Данное руководство включает некоторые возможности JavaScript, которые на данный момент доступны только в последних версиях Firefox, поэтому рекомендуется использовать последнюю версию Firefox.

+ +

В Firefox встроены два инструмента, полезных для экспериментирования с JavaScript: Web Console и Scratchpad.

+ +

Web Console

+ +

Web Console отображает информацию о текущей загруженной веб-странице, а также включает командную строку, которую вы можете использовать, чтобы выполнить выражения JavaScript на текущей странице.

+ +

Чтобы открыть Web Console, выберите "Web Console" из меню "Web Developer", которое находится под меню "Tools" в Firefox. Консоль появится в нижней части окна браузера. Вдоль нижней части консоли размещается командная строка, которую вы можете использовать для ввода JavaScript, результат выполнения появится на панели выше:

+ +

+ + + +
function greetMe(yourName) {
+  alert('Hello ' + yourName);
+}
+console.log(eval('3 + 5'));
+ + + +

Scratchpad

+ +

Web Console отлично подходит для выполнения одиночных строк JavaScript, но хотя вы можете выполнить и несколько строк, это не очень удобно, к тому же вы не можете сохранить ваш код, используя Web Console. Поэтому для более комплексных примеров Scratchpad является более подходящим инструментом.

+ +

Чтобы открыть Scratchpad(Shift+F4), выберите "Scratchpad" из меню "Web Developer", которое находится под меню "Tools" в Firefox. Блокнот будет открыт в отдельном окне, вы можете использовать его для создания и выполнения JavaScript в браузере. Вы также можете сохранять ваши скрипты на жесткий диск, а потом загружать их.

+ +

Если вы выберете "Display", то код в вашем блокноте будет выполнен в браузере, а результат вставлен обратно в блокнот как комментарий:

+ +

+ +

Hello world

+ +

Чтобы начать писать JavaScript код откройте Scratchpad и напишите свой первый "Hello World!" код:

+ +
(function(){
+  "use strict";
+  /* Start of your code */
+  function greetMe(yourName) {
+    alert('Hello ' + yourName);
+  }
+
+  greetMe('World');
+  /* End of your code */
+})();
+ +

Выберите код на панели и зажмите Ctrl + R, чтобы открыть код в браузере! На следующих страницах мы изучим синтаксис  и возможности JS, чтобы вы могли написать сложное более сложное приложение. Не забывайте добавлять перед кодом (function(){"use strict"; и })();  после. вы узнаете, что это означает, а пока считайте, что это —

+ +

1.  Значительно улучшает производительность

+ +

2.  Предотвращает структуры, которые могут запутать вас на начальном этапе.

+ +

3.  Предотвращает взаимодействие фрагментов кода, выполняемых в консоли.

+ +

{{PreviousNext("Web/JavaScript/Guide", "Web/JavaScript/Guide/Grammar_and_types")}}

diff --git a/files/ru/web/javascript/guide/ispolzovanie_promisov/index.html b/files/ru/web/javascript/guide/ispolzovanie_promisov/index.html deleted file mode 100644 index a910dfca09..0000000000 --- a/files/ru/web/javascript/guide/ispolzovanie_promisov/index.html +++ /dev/null @@ -1,321 +0,0 @@ ---- -title: Использование промисов -slug: Web/JavaScript/Guide/Ispolzovanie_promisov -tags: - - JavaScript - - Асинхронность - - Гайд - - промис -translation_of: Web/JavaScript/Guide/Using_promises ---- -
-

{{jsSidebar("Руководство по JavaScript")}}{{PreviousNext("Web/JavaScript/Guide/Details_of_the_Object_Model", "Web/JavaScript/Guide/Iterators_and_Generators")}}

-
- -

{{jsxref("Promise")}} (промис, англ. "обещание") - это объект, представляющий результат успешного или неудачного завершения асинхронной операции. Так как большинство людей пользуются уже созданными промисами, это руководство начнем с объяснения использования вернувшихся промисов до объяснения принципов создания. 

- -

В сущности, промис - это возвращаемый объект, в который вы записываете два коллбэка вместо того, чтобы передать их функции.

- -

Например, вместо старомодной функции, которая принимает два коллбэка и вызывает один из них в зависимости от успешного или неудачного завершения операции:

- -
function doSomethingOldStyle(successCallback, failureCallback) {
-  console.log("Готово.");
-  // Успех в половине случаев.
-  if (Math.random() > .5) {
-    successCallback("Успех")
-  } else {
-    failureCallback("Ошибка")
-  }
-}
-
-function successCallback(result) {
-  console.log("Успешно завершено с результатом " + result);
-}
-
-function failureCallback(error) {
-  console.log("Завершено с ошибкой " + error);
-}
-
-doSomethingOldStyle(successCallback, failureCallback);
-
- -

…современные функции возвращают промис, в который вы записываете ваши коллбэки:

- -
function doSomething() {
-  return new Promise((resolve, reject) => {
-    console.log("Готово.");
-    // Успех в половине случаев.
-    if (Math.random() > .5) {
-      resolve("Успех")
-    } else {
-      reject("Ошибка")
-    }
-  })
-}
-
-const promise = doSomething();
-promise.then(successCallback, failureCallback);
- -

…или просто:

- -
doSomething().then(successCallback, failureCallback);
- -

Мы называем это асинхронным вызовом функции. У этого соглашения есть несколько преимуществ. Давайте рассмотрим их.

- -

Гарантии

- -

В отличие от старомодных переданных коллбэков промис дает некоторые гарантии:

- - - -

Но наиболее непосредственная польза от промисов - цепочка вызовов (chaining).

- -

Цепочка вызовов

- -

Общая нужда - выполнять две или более асинхронных операции одна за другой, причём каждая следующая начинается при успешном завершении предыдущей и использует результат её выполнения. Мы реализуем это, создавая цепочку вызовов промисов (promise chain).

- -

Вот в чём магия: функция then возвращает новый промис, отличающийся от первоначального:

- -
let promise = doSomething();
-let promise2 = promise.then(successCallback, failureCallback);
-
- -

или

- -
let promise2 = doSomething().then(successCallback, failureCallback);
-
- -

Второй промис представляет завершение не только doSomething(), но и функций successCallback или failureCallback, переданных Вами, а они тоже могут быть асинхронными функциями, возвращающими промис. В этом случае все коллбэки, добавленные к promise2 будут поставлены в очередь за промисом, возвращаемым successCallback или failureCallback.

- -

По сути, каждый вызванный промис означает успешное завершение предыдущих шагов в цепочке.

- -

Раньше выполнение нескольких асинхронных операций друг за другом приводило к классической "Вавилонской башне" коллбэков:

- -
doSomething(function(result) {
-  doSomethingElse(result, function(newResult) {
-    doThirdThing(newResult, function(finalResult) {
-      console.log('Итоговый результат: ' + finalResult);
-    }, failureCallback);
-  }, failureCallback);
-}, failureCallback);
-
- -

В современных функциях мы записываем коллбэки в возвращаемые промисы - формируем цепочку промисов:

- -
doSomething().then(function(result) {
-  return doSomethingElse(result);
-})
-.then(function(newResult) {
-  return doThirdThing(newResult);
-})
-.then(function(finalResult) {
-  console.log('Итоговый результат: ' + finalResult);
-})
-.catch(failureCallback);
-
- -

Аргументы then необязательны, а catch(failureCallback) - это сокращение для then(null, failureCallback). Вот как это выражено с помощью стрелочных функций:

- -
doSomething()
-.then(result => doSomethingElse(result))
-.then(newResult => doThirdThing(newResult))
-.then(finalResult => {
-  console.log(`Итоговый результат: ${finalResult}`);
-})
-.catch(failureCallback);
-
- -

Важно: Всегда возвращайте промисы в return, иначе коллбэки не будут сцеплены и ошибки могут быть не пойманы (стрелочные функции неявно возвращают результат, если скобки {} вокруг тела функции опущены).

- -

Цепочка вызовов после catch

- -

Можно продолжить цепочку вызовов после ошибки, т. е. после catch, что полезно для выполнения новых действий даже после того, как действие вернет ошибку в цепочке вызовов. Ниже приведен пример:

- -
new Promise((resolve, reject) => {
-    console.log('Начало');
-
-    resolve();
-})
-.then(() => {
-    throw new Error('Где-то произошла ошибка');
-
-    console.log('Выведи это');
-})
-.catch(() => {
-    console.log('Выведи то');
-})
-.then(() => {
-    console.log('Выведи это, несмотря ни на что');
-});
- -

В результате выведется данный текст:

- -
Начало
-Выведи то
-Выведи это, несмотря ни на что
- -

Заметьте, что текст "Выведи это" не вывелся, потому что "Где то произошла ошибка" привела к отказу

- -

Распространение ошибки

- -

Вы могли ранее заметить, что failureCallback  повторяется три раза  в "pyramid of doom", а в цепочке промисов всего лишь один раз:

- -
doSomething()
-.then(result => doSomethingElse(result))
-.then(newResult => doThirdThing(newResult))
-.then(finalResult => console.log(`Итоговый результат: ${finalResult}`))
-.catch(failureCallback);
- -

В основном, цепочка промисов останавливает выполнение кода, если где-либо произошла ошибка, и вместо этого ищет далее по цепочке обработчики ошибок. Это очень похоже на то, как работает синхронный код:

- -
try {
-  let result = syncDoSomething();
-  let newResult = syncDoSomethingElse(result);
-  let finalResult = syncDoThirdThing(newResult);
-  console.log(`Итоговый результат: ${finalResult}`);
-} catch(error) {
-  failureCallback(error);
-}
-
- -

Эта симметрия с синхронным кодом лучше всего показывает себя в синтаксическом сахаре async/await в ECMAScript 2017:

- -
async function foo() {
-  try {
-    let result = await doSomething();
-    let newResult = await doSomethingElse(result);
-    let finalResult = await doThirdThing(newResult);
-    console.log(`Итоговый результат: ${finalResult}`);
-  } catch(error) {
-    failureCallback(error);
-  }
-}
-
- -

Работа данного кода основана на промисах. Для примера здесь используется функция doSomething(), которая встречалась ранее. Вы можете прочитать больше о синтаксисе здесь

- -

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

- -

Создание промиса вокруг старого коллбэка

- -

{{jsxref("Promise")}} может быть создан с помощью конструктора. Это может понадобится только для старых API.

- -

В идеале, все асинхронные функции уже должны возвращать промис. Но увы, некоторые APIs до сих пор ожидают успешного или неудачного  коллбека переданных по старинке. Типичный пример: {{domxref("WindowTimers.setTimeout", "setTimeout()")}} функция:

- -
setTimeout(() => saySomething("10 seconds passed"), 10000);
- -

Смешивание старого коллбэк-стиля и промисов проблематично. В случае неудачного завершения saySomething или программной ошибки, нельзя обработать ошибку.

- -

К с частью мы можем обернуть функцию в промис. Хороший тон оборачивать проблематичные функции на самом низком возможном уровне, и больше никогда их не вызывать на прямую:

- -
const wait = ms => new Promise(resolve => setTimeout(resolve, ms));
-
-wait(10000).then(() => saySomething("10 seconds")).catch(failureCallback);
- -

В сущности, конструктор промиса становится исполнителем функции, который позволяет нам резолвить или режектить промис вручную. Так как setTimeout всегда успешен, мы опустили reject в этом случае.

- -

Композиция

- -

{{jsxref("Promise.resolve()")}} и {{jsxref("Promise.reject()")}} короткий способ создать уже успешные или отклоненные промисы соответственно. Это иногда бывает полезно.

- -

{{jsxref("Promise.all()")}} и {{jsxref("Promise.race()")}} - два метода запустить асинхронные операции параллельно.

- -

Последовательное выполнение композиции возможно при помощи хитрости JavaScript:

- -
[func1, func2].reduce((p, f) => p.then(f), Promise.resolve());
- -

Фактически, мы превращаем массив асинхронных функций в цепочку промисов равносильно: Promise.resolve().then(func1).then(func2);

- -

Это также можно сделать, объеденив композицию в функцию, в функциональном стиле программирования:

- -
const applyAsync = (acc,val) => acc.then(val);
-const composeAsync = (...funcs) => x => funcs.reduce(applyAsync, Promise.resolve(x));
- -

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

- -
const transformData = composeAsync(func1, asyncFunc1, asyncFunc2, func2);
-transformData(data);
- -

В ECMAScript 2017, последовательные композиции могут быть выполненны более простым способом с помощью async/await:

- -
for (const f of [func1, func2]) {
-  await f();
-}
- -

Порядок выполнения

- -

Чтобы избежать сюрпризов, функции, переданные в then никогда не будут вызванны синхронно, даже с уже разрешенным промисом:

- -
Promise.resolve().then(() => console.log(2));
-console.log(1); // 1, 2
- -

Вместо немедленного выполнения, переданная функция встанет в очередь микрозадач, а значит выполнится, когда очередь будет пустой  в конце текущего вызова JavaScript цикла событий (event loop), т.е. очень скоро:

- -
const wait = ms => new Promise(resolve => setTimeout(resolve, ms));
-
-wait().then(() => console.log(4));
-Promise.resolve().then(() => console.log(2)).then(() => console.log(3));
-console.log(1); // 1, 2, 3, 4
- -

Вложенность

- -

Простые цепочки promise лучше оставлять без вложений, так как вложеность может быть результатом небрежной структуры. Смотрите распространенные ошибки.

- -

Вложенность - это управляющая структура, ограничивающая область действия операторов catch. В частности, вложенный catch только перехватывает сбои в своей области и ниже, а не ошибки выше в цепочке за пределами вложенной области. При правильном использовании это дает большую точность в извлечение ошибок:

- -
doSomethingCritical()
-.then(result => doSomethingOptional()
-  .then(optionalResult => doSomethingExtraNice(optionalResult))
-  .catch(e => {})) // Игнорируется если необязательные параметр не выкинул исключение
-.then(() => moreCriticalStuff())
-.catch(e => console.log("Критическая ошибка: " + e.message));
- -

Обратите внимание, что необязательный шаги здесь выделены отступом.

- -

Внутренний оператор catch нейтрализует и перехватывает ошибки только от doSomethingOptional() и doSomethingExtraNice(), после чего код возобновляется с помощью moreCriticalStuff(). Важно, что в случае сбоя doSomethingCritical() его ошибка перехватывается только последним (внешним) catch.

- -

Частые ошибки

- -

В этом разделе собраны частые ошибки, возникающие при создании цепочек обещаний. Несколько таких ошибок можно увидеть в следующем примере:

- -
// Плохой пример! Три ошибки!
-
-doSomething().then(function(result) {
-  doSomethingElse(result) // Забыл вернуть обещание из внутренней цепочки + неуместное влаживание
-  .then(newResult => doThirdThing(newResult));
-}).then(() => doFourthThing());
-// Забыл закончить цепочку методом catch
- -

Первая ошибка это неправильно сцепить вещи между собой. Такое происходит когда мы создаем промис но забываем вернуть его. Как следствие, цепочка сломана, но правильнее было бы сказать что теперь у нас есть две независимые цепочки, соревнующиеся за право разрешится первой. Это означает doFourthThing() не будет ждать doSomethingElse() или doThirdThing() пока тот закончится, и будет исполнятся параллельно с ними, это ,вероятно, не то что хотел разработчик. Отдельные цепочки также имеют отдельную обработку ошибок, что приводит к необработанным ошибкам.

- -

Вторая ошибка это излишняя вложенность, включая первую ошибку. Вложенность также ограничивает область видимости внутренних обработчиков ошибок, если это не то чего хотел разработчик, это может привести к необработанным ошибкам. Примером этого является пример как не нужно создавать обещания, который комбинирует вложенность с чрезмерным использованием конструктора обещаний для оборачивания кода который уже использует промисы.

- -

Третяя ошибка это забыть закончить цепочку ключевым словом catch. Незаконченные цепочки приводят к необработанным отторжениям обещаний в большинстве браузеров.

- -

Хорошим примером является всегда либо возвращать либо заканчивать цепочки обещаний, и как только вы получаете новое обещание, возвращайте его сразу же, чтобы не усложнять код излишней вложенностью:

- -
doSomething()
-.then(function(result) {
-  return doSomethingElse(result);
-})
-.then(newResult => doThirdThing(newResult))
-.then(() => doFourthThing())
-.catch(error => console.log(error));
- -

Обратите внимание что () => x  это сокращенная форма () => { return x; }.

- -

Теперь у нас имеется единственная определенная цепочка с правильной обработкой ошибок.

- -

Использование async/await предотвращает большинство, если не все вышеуказанные ошибки—но взамен появляется другая частая ошибка—забыть ключевое слово await.

- -

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

- - diff --git a/files/ru/web/javascript/guide/javascript_overview/index.html b/files/ru/web/javascript/guide/javascript_overview/index.html deleted file mode 100644 index 5db1f95ca4..0000000000 --- a/files/ru/web/javascript/guide/javascript_overview/index.html +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: Обзор JavaScript -slug: Web/JavaScript/Guide/JavaScript_Overview -translation_of: Web/JavaScript/Guide/Introduction -translation_of_original: Web/JavaScript/Guide/JavaScript_Overview ---- -

Эта глава является введением в JavaScript и описывает некоторые из базовых понятий.

- -

Что такое JavaScript?

- -

JavaScript это кросс-платформенный, объектно-ориентированный, скриптовый язык. JavaScript - это маленький и легковесный язык; он спроектирован не для создания законченных, полноценных приложений,  а для легкого встраивания в другие продукты и приложения, например, в веб браузеры. Внутри основного приложения, JavaScript может соединяться с объектами этого приложения и осуществлять программный контроль над ними.

- -

Ядро JavaScript содержит набор базовых объектов, например Array, Date и Math, и набор элементов языка: операторов, управляющих структур, и выражений. Ядро JavaScript может быть расширено для различных целей с помощью дополнений, например:

- - - -

Используя функции JavaScript LiveConnect, Вы можете позволить коду на Java и JavaScript общаться между собой. Вы можете создать экземпляр объекта Java из JavaScript и получить доступ к его публичным методам и свойствам. Из Java, Вы можете получить доступ к объектам, свойствам и методам JavaScript.

- -

Впервые JavaScript был использован в браузерах Netscape.

- -

JavaScript и Java

- -

JavaScript и Java схожи в некоторых отношениях, но принципиально отличаются в других. Язык JavaScript напоминает Java, но не имеет статической типизации и строгой проверки типов. В основном, JavaScript следует большей части синтакса Java в выражениях, именованиях и основного потока управления конструкциями, что стало причиной, почему он был переименован из LiveScript в JavaScript.

- -

В отличии от системы компилированных классов в Java, построенной на объявлениях, JavaScript поддерживает систему исполнения, основанную на небольшом количестве типов данных, представляющих числовые, логические и строковые значения. JavaScript обладает моделью объектов на базе прототипов вместо более общей модели объектов на базе классов. Модель объектов на базе прототипов делает возможным динамическое наследование; то есть, то, что унаследовано, может различаться для отдельных объектов. JavaScript также поддерживает функции без каких-либо специальных декларативных требований. Функции могут быть свойствами объектов, выполняться как слабо типизированные методы.

- -

По сравнению с Java, JavaScript - это язык с очень свободной формой языка. Вам не надо объявлять переменные, классы или методы. Вы не должны беспокоиться, является ли метод public, private или protected, Вам не надо реализовывать интерфейсы. Переменные, параметры и возвращаемые функциями типы не являются явно типизированными.

- -

Java - язык программирования на основе классов, предназначенный для быстрого выполнения и безопасности типов. Безопасность типов означает, например, что Вы не можете взять тип Java integer и привести его к типу object reference или получить доступ к закрытой памяти изменяя байт-код Java. Ориентированная на классы модель Java означает, что программы состоят исключительно из классов и их методов. Наследование классов и строгая типизация в Java обычно тербуют тесно связанную иерархию объектов. Эти требования делают программирование на Java более сложным чем на JavaScript.

- -

По духу JavaScript происходит от нескольких небольших, динамически типизированных языков программирования, таких как HyperTalk и dBASE. Эти скриптовые языки предлагают инструменты программирования для гораздо более широкой аудитории благодаря более простому синтаксису, специальной встроенной функциональности и минимальным требованиям для создания объектов.

- - - - - - - - - - - - - - - - - - - - - - - -
Таблица 1.1 Сравнение JavaScript и Java
JavaScriptJava
Объектно-ориентированный. Нет различий между типами объектов. Наследование реализовано через механизм прототипов, свойства и методы могут быть динамически добавлены к любому объекту.На базе классов. Объекты делятся на классы и экземпляры с наследованием через иерархию классов. Классы и экземпляры не могут иметь динамически добавленные свойства и методы.
Типы данных переменных не объявлены (динамическая типизация).Типы данных переменных должны быть объявлены (статическая типизация).
Не может автоматически записывать на жесткий диск.Может автоматически записывать на жесткий диск.
- -

Для получения дополнительной информации о различиях между JavaScript и Java, см. раздел Details of the Object Model.

- -

JavaScript and the ECMAScript Specification

- -

Netscape invented JavaScript, and JavaScript was first used in Netscape browsers. However, Netscape is working with Ecma International — the European association for standardizing information and communication systems (ECMA was formerly an acronym for the European Computer Manufacturers Association) to deliver a standardized, international programming language based on core JavaScript. This standardized version of JavaScript, called ECMAScript, behaves the same way in all applications that support the standard. Companies can use the open standard language to develop their implementation of JavaScript. The ECMAScript standard is documented in the ECMA-262 specification.

- -

The ECMA-262 standard is also approved by the ISO (International Organization for Standardization) as ISO-16262. You can find a PDF version of ECMA-262 (outdated version) at the Mozilla website. You can also find the specification on the Ecma International website. The ECMAScript specification does not describe the Document Object Model (DOM), which is standardized by the World Wide Web Consortium (W3C). The DOM defines the way in which HTML document objects are exposed to your script.

- -

Relationship between JavaScript Versions and ECMAScript Editions

- -

Netscape worked closely with Ecma International to produce the ECMAScript Specification (ECMA-262). The following table describes the relationship between JavaScript versions and ECMAScript editions.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Table 1.2 JavaScript versions and ECMAScript editions
JavaScript versionRelationship to ECMAScript edition
JavaScript 1.1ECMA-262, Edition 1 is based on JavaScript 1.1.
JavaScript 1.2ECMA-262 was not complete when JavaScript 1.2 was released. JavaScript 1.2 is not fully compatible with ECMA-262, Edition 1, for the following reasons: -
    -
  • Netscape developed additional features in JavaScript 1.2 that were not considered for ECMA-262.
    • -
  • ECMA-262 adds two new features: internationalization using Unicode, and uniform behavior across all platforms. Several features of JavaScript 1.2, such as the Date object, were platform-dependent and used platform-specific behavior.
    • -
-
-

JavaScript 1.3

- 		-

JavaScript 1.3 is fully compatible with ECMA-262, Edition 1.

- -

JavaScript 1.3 resolved the inconsistencies that JavaScript 1.2 had with ECMA-262, while keeping all the additional features of JavaScript 1.2 except == and !=, which were changed to conform with ECMA-262.

-
-

JavaScript 1.4

- 		-

JavaScript 1.4 is fully compatible with ECMA-262, Edition 1.

- -

The third version of the ECMAScript specification was not finalized when JavaScript 1.4 was released.

-
JavaScript 1.5JavaScript 1.5 is fully compatible with ECMA-262, Edition 3.
- -
Note: ECMA-262, Edition 2 consisted of minor editorial changes and bug fixes to the Edition 1 specification. The  current release by the TC39 working group of Ecma International is ECMAScript Edition 5.1
- -

The JavaScript Reference indicates which features of the language are ECMAScript-compliant.

- -

JavaScript will always include features that are not part of the ECMAScript Specification; JavaScript is compatible with ECMAScript, while providing additional features.

- -

JavaScript Documentation versus the ECMAScript Specification

- -

The ECMAScript specification is a set of requirements for implementing ECMAScript; it is useful if you want to determine whether a JavaScript feature is supported in other ECMAScript implementations. If you plan to write JavaScript code that uses only features supported by ECMAScript, then you may need to review the ECMAScript specification.

- -

The ECMAScript document is not intended to help script programmers; use the JavaScript documentation for information on writing scripts.

- -

JavaScript and ECMAScript Terminology

- -

The ECMAScript specification uses terminology and syntax that may be unfamiliar to a JavaScript programmer. Although the description of the language may differ in ECMAScript, the language itself remains the same. JavaScript supports all functionality outlined in the ECMAScript specification.

- -

The JavaScript documentation describes aspects of the language that are appropriate for a JavaScript programmer. For example:

- - diff --git a/files/ru/web/javascript/guide/loops_and_iteration/index.html b/files/ru/web/javascript/guide/loops_and_iteration/index.html new file mode 100644 index 0000000000..231bc70804 --- /dev/null +++ b/files/ru/web/javascript/guide/loops_and_iteration/index.html @@ -0,0 +1,362 @@ +--- +title: Циклы и итерации +slug: Web/JavaScript/Guide/Циклы_и_итерации +tags: + - for + - операторы цикла + - циклы +translation_of: Web/JavaScript/Guide/Loops_and_iteration +--- +
{{jsSidebar("JavaScript Guide")}} {{PreviousNext("Web/JavaScript/Guide/Control_flow_and_error_handling", "Web/JavaScript/Guide/Functions")}}
+ +

Циклы - простой способ сделать какое-то действие несколько раз. Эта глава руководства JavaScript Guide познакомит вас с различными операторами доступными в JavaScript.

+ +

Вы можете представить цикл в виде компьютеризированной версии игры, где вы говорите кому-то сделать X шагов в одном направлении, затем Y шагов в другом; для примера, идея игры "Иди 5 шагов на восток" может быть выражена в виде цикла:

+ +
var step;
+for (step = 0; step < 5; step++) {
+  // Запускается 5 раз, с шагом от 0 до 4.
+  console.log('Идём 1 шаг на восток');
+}
+
+ +

Существует множество различных видов циклов, но все они по сути делают тоже самое: повторяют какое-либо действие несколько раз (не забывайте про нулевой раз повторения, отсчёт в массиве начинается с 0). Различные по строению циклы предлагают разные способы для определения начала и окончания цикла. Для различных задач программирования существуют свои операторы цикла, с помощью которых они решаются намного проще.

+ +

Операторы предназначеные для организации циклов в  JavaScript:

+ + + +

Цикл for 

+ +

Цикл for  повторяет действия, пока не произойдёт какое-либо специальное событие завершения цикла. Оператор for в JavaScript аналогичен оператору for в Java и C. Объявление оператора for выглядит следующим образом:

+ +
for ([начало]; [условие]; [шаг]) выражения
+
+ +

При его выполнении происходит следущее:

+ +
    +
  1. Выполняется выражение начало, если оно указано. Это выражение обычно инициализирует один или несколько счётчиков, но синтаксис позволяет выражению быть любой сложности. Также используется для объявления переменных.
    2. +
  2. Выполняется условие. Если условие истинно, то выполняются выражения. Если оно ложно, цикл for прерывается. Если же условие полностью пропущено, то оно считается истинным.
    3. +
  3. Выполняются выражения. Чтобы выполнить несколько выражений, используются блок-выражение  { ... }  для группировки выражений.
    4. +
  4. Обновляется шаг, если он есть, а затем управление возвращается к шагу 2.
    5. +
+ +

Пример

+ +

В следующей функции есть цикл for, который считает количество выбранных жанров в списке прокрутки (элемент {{HTMLElement("select")}}, который позволяет выбрать несколько элементов). Цикл for объявляет переменную i и задаёт ей значение 0. Также он проверяет, что i меньше количества элементов в элементе <select>, выполняет оператор if и увеличивает i на один после каждого прохода цикла.

+ +
<form name="selectForm">
+  <p>
+    <label for="musicTypes">Выберите некоторые жанры музыки, а затем нажмите на кнопку ниже:</label>
+    <select id="musicTypes" name="musicTypes" multiple="multiple">
+      <option selected="selected">R&B</option>
+      <option>Jazz</option>
+      <option>Blues</option>
+      <option>New Age</option>
+      <option>Classical</option>
+      <option>Opera</option>
+    </select>
+  </p>
+  <p><input id="btn" type="button" value="Как много выбрано?" /></p>
+</form>
+
+<script>
+function howMany(selectObject) {
+  var numberSelected = 0;
+  for (var i = 0; i < selectObject.options.length; i++) {
+    if (selectObject.options[i].selected) {
+      numberSelected++;
+    }
+  }
+  return numberSelected;
+}
+
+var btn = document.getElementById("btn");
+btn.addEventListener("click", function(){
+  alert('Выбрано элементов: ' + howMany(document.selectForm.musicTypes))
+});
+</script>
+
+
+ +

Цикл do...while 

+ +

Цикл do...while повторяется пока заданное условие истинно. Оператор do...while имеет вид:

+ +
do
+  выражения
+while (условие);
+
+ +

выражения выполняются пока условие истинно. Чтобы использовать несколько выражений, используйте блок-выражение  { ... }, чтобы сгруппировать их. Если условие истинно, выражения выполнятся снова. В конце каждого прохода условие проверяется. Если условие ложно, выполнение приостанавливается и управление передаётся выражению после do...while.

+ +

Пример

+ +

В следующем примере, цикл do выполнится минимум 1 раз и запускается снова, пока i меньше 5.

+ +
do {
+  i += 1;
+  console.log(i);
+} while (i < 5);
+ +

Цикл while

+ +

Цикл while выполняет выражения пока условие истинно. Выглядит он так:

+ +
while (условие)
+  выражения
+
+ +

Если условие становится ложным, выражения в цикле перестают выполняться и управление переходит к выражению после цикла.

+ +

Условие проверяется на истинность до того, как выполняются выражения в цикле. Если условие истинно, выполняются выражения, а затем условие проверяется снова. Если условие ложно, выполнение приостанавливается и управление переходит к выражению после while.

+ +

Чтобы использовать несколько выражений, используйте блок выражение { ... }, чтобы сгруппировать их.

+ +

Пример 1

+ +

Следующий цикл while работает, пока n меньше трёх:

+ +
var n = 0;
+var x = 0;
+while (n < 3) {
+  n++;
+  x += n;
+}
+
+ +

С каждой итерацией, цикл увеличивает n и добавляет это значение к x. Поэтому, x и n получают следующие значения:

+ + + +

После третьего прохода, условие n < 3 становится ложным, поэтому цикл прерывается.

+ +

Пример 2

+ +

Избегайте бесконечных циклов. Убедитесь, что условие цикла в итоге станет ложным; иначе, цикл никогда не прервётся. Выражения в следующем цикле while будут выполняться вечно, т.к. условие никогда не станет ложным:

+ +
while (true) {
+  console.log("Hello, world");
+}
+ +

Метка (label)

+ +

Метка представляет собой оператор с индентификатором, который позволяет вам ссылаться на какое-то место в вашей программе. Например, вы можете использовать метку, чтобы обозначить цикл, а затем использовать операторы break или continue, чтобы указать, должна ли программа прерывать цикл или продолжать его выполнение.

+ +

Синтаксис метки следующий:

+ +
метка :
+   оператор
+
+ +

Значение метки может быть любым корректным JavaScript индентификатором, не являющимся зарезервированным словом. Оператор, указанный вами после метки может быть любым выражением.

+ +

Пример

+ +

В этом примере, метка markLoop обозначает цикл while.

+ +
markLoop:
+while (theMark == true) {
+   doSomething();
+}
+ +

break

+ +

Используйте оператор break, чтобы прерывать цикл, переключать управление или в сочетании с оператором метка.

+ + + +

Синтаксис оператора может быть таким:

+ +
    +
  1. break;
    2. +
  2. break Метка;
    3. +
+ +

Первая форма синтаксиса прерывает цикл совсем или переключает управление; вторая прерывает специально обозначенное выражение.

+ +

Пример 1

+ +

Следующий пример проходит по элементам в массиве, пока не найдёт элемент, чьё значение - theValue:

+ +
for (i = 0; i < a.length; i++) {
+  if (a[i] == theValue) {
+    break;
+  }
+}
+ +

Пример 2: Прерывание метки

+ +
var x = 0;
+var z = 0
+labelCancelLoops: while (true) {
+  console.log("Внешний цикл: " + x);
+  x += 1;
+  z = 1;
+  while (true) {
+    console.log("Внутренний цикл: " + z);
+    z += 1;
+    if (z === 10 && x === 10) {
+      break labelCancelLoops;
+    } else if (z === 10) {
+      break;
+    }
+  }
+}
+
+ +

continue

+ +

Оператор continue используется, чтобы шагнуть на шаг вперёд в циклах while, do-while, for или перейти к метке.

+ + + +

Синтаксис continue может выглядеть так:

+ +
    +
  1. continue;
    2. +
  2. continue Метка;
    3. +
+ +

Пример 1

+ +

Следующий пример показывает цикл while с оператором continue, который срабатывает, когда значение i равно 3. Таким образом, n получает значения 1, 3, 7 и 12.

+ +
var i = 0;
+var n = 0;
+while (i < 5) {
+  i++;
+  if (i == 3) {
+    continue;
+  }
+  n += i;
+}
+
+ +

Пример 2

+ +

Выражение, отмеченное checkiandj содержит выражение отмеченное checkj. При встрече с continue, программа прерывает текущую итерацию checkj и начинает следующую итерацию. Каждый раз при встрече с continue, checkj переходит на следующую итерацию, пока условие возвращает false. Когда возвращается false, после вычисления остатка от деления checkiandj, checkiandj переходит на следующую итерацию, пока его условие возвращает false. Когда возвращается false, программа продолжает выполнение с выражения после checkiandj.

+ +

Если у continue проставлена метка checkiandj, программа может продолжиться с начала метки checkiandj.

+ +
checkiandj:
+  while (i < 4) {
+    console.log(i);
+    i += 1;
+    checkj:
+      while (j > 4) {
+        console.log(j);
+        j -= 1;
+        if ((j % 2) != 0) {
+          continue checkj;
+        }
+        console.log(j + " чётное.");
+      }
+      console.log("i = " + i);
+      console.log("j = " + j);
+  }
+ +

for...in 

+ +

Оператор for...in проходит по всем перечислимым свойствам объекта. JavaScript выполнит указанные выражения для каждого отдельного свойства. Цикл for...in выглядит так:

+ +
for (variable in object) {
+  выражения
+}
+
+ +

Пример

+ +

Следующая функция берёт своим аргументом объект и его имя. Затем проходит по всем свойствам объекта и возвращает строку, которая содержит имена свойств и их значения.

+ +
function dump_props(obj, obj_name) {
+  var result = "";
+  for (var i in obj) {
+    result += obj_name + "." + i + " = " + obj[i] + "<br>";
+  }
+  result += "<hr>";
+  return result;
+}
+
+ +

Для объекта car со свойствами make и model, результатом будет:

+ +
car.make = Ford
+car.model = Mustang
+
+ +

Пример №2

+ +

Также, по ключу можно выводить значение:

+ +
let obj = {model: 'AUDI A8', year: '2019', color: 'brown'}
+
+for (key in obj) {
+  console.log(`${key} = ${obj[key]}`);
+}
+// model = AUDI A8
+// year = 2019
+// color = brown
+ +

Массивы

+ +

Хотя, очень заманчиво использовать for...in как способ пройтись по всем элементам {{jsxref("Array")}}, этот оператор возвращает имя свойств определённых пользователем помимо числовых индексов. Таким образом лучше использовать стандартный for для числовых индексов при взаимодействии с массивами, поскольку оператор for...in проходит по определённым пользователем свойствам в дополнение к элементам массива, если вы изменяете массив, например, добавляете свойства и методы.

+ +

Пример

+ +
let arr = ['AUDI A8', '2019', 'brown'];
+arr.cost = '$100.000';
+
+for (key in arr) {
+  console.log(`${key} = ${arr[key]}`);
+}
+
+// 0 = AUDI A8
+// 1 = 2019
+// 2 = brown
+// cost = $100.000
+
+ +

for...of

+ +

Оператор for...of создаёт цикл, проходящий по перечислимым объектам (включая {{jsxref("Array")}}, {{jsxref("Map")}}, {{jsxref("Set")}}, объект arguments и так далее), вызывая на каждой итерации функцию с выражениями, которые надо выполнить для получения значения каждого отдельного свойства.

+ +
for (variable of object) {
+  выражения
+}
+ +

Следующий пример показывает разницу между циклами for...of и for...in. Тогда как for...in проходит по именам свойств, for...of проходит по значениям свойств:

+ +
let arr = [3, 5, 7];
+arr.foo = "hello";
+
+for (let i in arr) {
+   console.log(i); // выводит "0", "1", "2", "foo"
+}
+
+for (let i of arr) {
+   console.log(i); // выводит "3", "5", "7"
+}
+
+ +

{{PreviousNext("Web/JavaScript/Guide/Control_flow_and_error_handling", "Web/JavaScript/Guide/Functions")}}

diff --git a/files/ru/web/javascript/guide/predefined_core_objects/index.html b/files/ru/web/javascript/guide/predefined_core_objects/index.html deleted file mode 100644 index a0f5770315..0000000000 --- a/files/ru/web/javascript/guide/predefined_core_objects/index.html +++ /dev/null @@ -1,923 +0,0 @@ ---- -title: Predefined Core Objects -slug: Web/JavaScript/Guide/Predefined_Core_Objects -translation_of: Web/JavaScript/Guide -translation_of_original: Web/JavaScript/Guide/Predefined_Core_Objects ---- -

Эта глава описывает предопределённые объекты в стандартном JavaScript: Array, Boolean, Date, Function, Math, Number, RegExp, и String.

- -

Объект Array

- -

В JavaScript массив как тип данных отсутствует. Тем не менее, вы можете использовать предопределённый объект Array и его методы, чтобы работать с массивами в ваших приложениях. Объект Array содержит различные методы для манипуляций с массивами, такими как объединение, обращение и сортировка. У него есть свойство для определения длины массива и другие свойства для работы с регулярными выражениями.

- -

Массив - это упорядоченный набор значений, обращаться к которым можно с помощью имени и индекса. Например, можно создать массив emp, который содержит имена сотрудников фирмы, проиндексированные номерами. Тогда emp[1] будет соответствовать сотруднику номер один, emp[2] сотруднику номер два и так далее.

- -

Создание объекта Array

- -

Следующие инструкции создают эквивалентные массивы:

- -
-
var arr = new Array(element0, element1, ..., elementN);
-var arr = Array(element0, element1, ..., elementN);
-var arr = [element0, element1, ..., elementN];
-
-
- -

element0, element1, ..., elementN это список значений во вновь создаваемом массиве. Когда эти значения заданы, массив инициализирует ими свои эелементы. Длина массива определяется по числу аргументов и сохраняется в свойстве length (длина).

- -

Синтаксис с квадратными скобками называется "литералом массива" (array literal) или "инициализатором массива" (array initializer). Такая запись короче других и используется чаще. Подробности смотрите в Array Literals.

- -

Создать массив ненулевой длины, но без элементов, можно одним из следующих способов:

- -
var arr = new Array(arrayLength);
-var arr = Array(arrayLength);
-
-// This has exactly the same effect
-var arr = [];
-arr.length = arrayLength;
-
- -

Обратите внимание: в приведённом выше коде arrayLength должен быть значением типа Number, то есть числом, иначе будет создан массив с одним элементом (переданным конструктору значением). Вызов arr.length возвратит arrayLength, хотя на самом деле элемент содержит пустые (неопределённые, undefined) элементы. Итерация по массиву циклом for...in не возвратит никаких элементов.

- -

Массивы можно не только определить как и переменные, но и присвоить существующему объекту как свойство:

- -
var obj = {};
-// ...
-obj.prop = [element0, element1, ..., elementN];
-
-// OR
-var obj = {prop: [element0, element1, ...., elementN]}
-
- -

Если же вы хотите создать одноэлементный массив, содержащий число, придётся использовать запись с квадратными скобками, так как когда конструктору Array() передаётся одно-единственное число, оно трактуется как длина массива, а не как хранимвый элемент.

- -
var arr = [42];
-var arr = Array(42); // Creates an array with no element, but with arr.length set to 42
-
-// The above code is equivalent to
-var arr = [];
-arr.length = 42;
-
-
- -

Вызов Array(N) приводит к RangeError, если N не является целым числом, чья дробная часть не равна нулю. Следующий пример иллюстрирует это поведение.

- -
var arr = Array(9.3);  // RangeError: Invalid array length
-
- -

Если ваш код должен создавать массивы с отдельными элементами произвольного типа, безопаснее использовать литералы массива. Или, создайте пустой массив, прежде чем добавлять элементы к нему.

- -

Заполнение массива

- -

You can populate an array by assigning values to its elements. For example,

- -
var emp = [];
-emp[0] = "Casey Jones";
-emp[1] = "Phil Lesh";
-emp[2] = "August West";
-
- -

Note: if you supply a non-integer value to the array operator in the code above, a property will be created in the object representing the array, instead of an array element.

- -
 var arr = [];
-arr[3.4] = "Oranges";
-console.log(arr.length);                // 0
-console.log(arr.hasOwnProperty(3.4));   // true
-
- -

You can also populate an array when you create it:

- -
var myArray = new Array("Hello", myVar, 3.14159);
-var myArray = ["Mango", "Apple", "Orange"]
-
- -

Referring to Array Elements

- -

You refer to an array's elements by using the element's ordinal number. For example, suppose you define the following array:

- -
var myArray = ["Wind", "Rain", "Fire"];
-
- -

You then refer to the first element of the array as myArray[0] and the second element of the array as myArray[1]. The index of the elements begins with zero.

- -

Note: the array operator (square brackets) is also used for accessing the array's properties (arrays are also objects in JavaScript). For example,

- -
 var arr = ["one", "two", "three"];
-arr[2];  // three
-arr["length"];  // 3
-
- -

Understanding length

- -

At the implementation level, JavaScript's arrays actually store their elements as standard object properties, using the array index as the property name. The length property is special; it always returns the index of the last element plus one (in following example Dusty is indexed at 30 so cats.length returns 30 + 1). Remember, Javascript Array indexes are 0-based: they start at 0, not 1. This means that the length property will be one more than the highest index stored in the array:

- -
var cats = [];
-cats[30] = ['Dusty'];
-print(cats.length); // 31
-
- -

You can also assign to the length property. Writing a value that is shorter than the number of stored items truncates the array; writing 0 empties it entirely:

- -
var cats = ['Dusty', 'Misty', 'Twiggy'];
-console.log(cats.length); // 3
-
-cats.length = 2;
-console.log(cats); // prints "Dusty,Misty" - Twiggy has been removed
-
-cats.length = 0;
-console.log(cats); // prints nothing; the cats array is empty
-
-cats.length = 3;
-console.log(cats); // [undefined, undefined, undefined]
-
- -

Iterating over arrays

- -

A common operation is to iterate over the values of an array, processing each one in some way. The simplest way to do this is as follows:

- -
var colors = ['red', 'green', 'blue'];
-for (var i = 0; i < colors.length; i++) {
-  console.log(colors[i]);
-}
-
- -

If you know that none of the elements in your array evaluate to false in a boolean context — if your array consists only of DOM nodes, for example, you can use a more efficient idiom:

- -
var divs = document.getElementsByTagName('div');
-for (var i = 0, div; div = divs[i]; i++) {
-  /* Process div in some way */
-}
-
- -

This avoids the overhead of checking the length of the array, and ensures that the div variable is reassigned to the current item each time around the loop for added convenience.

- -

The forEach() method, introduced in JavaScript 1.6, provides another way of iterating over an array:

- -
var colors = ['red', 'green', 'blue'];
-colors.forEach(function(color) {
-  console.log(color);
-});
-
- -

The function passed to forEach is executed once for every item in the array, with the array item passed as the argument to the function. Unassigned values are not iterated in a forEach loop.

- -

Note that the elements of array omitted when the array is defined are not listed when iterating by forEach, but are listed when undefined has been manually assigned to the element:

- -
var array = ['first', 'second', , 'fourth'];
-
-// returns ['first', 'second', 'fourth'];
-array.forEach(function(element) {
-  console.log(element);
-})
-
-if(array[2] === undefined) { console.log('array[2] is undefined'); } // true
-
-var array = ['first', 'second', undefined, 'fourth'];
-
-// returns ['first', 'second', undefined, 'fourth'];
-array.forEach(function(element) {
-  console.log(element);
-})
- -

Since JavaScript elements are saved as standard object properties, it is not advisable to iterate through JavaScript arrays using for...in loops because normal elements and all enumerable properties will be listed.

- -

Array Methods

- -

The Array object has the following methods:

- - - -

Compatibility code for older browsers can be found for each of these functions on the individual pages. Native browser support for these features in various browsers can be found here.

- - - -

The methods above that take a callback are known as iterative methods, because they iterate over the entire array in some fashion. Each one takes an optional second argument called thisObject. If provided, thisObject becomes the value of the this keyword inside the body of the callback function. If not provided, as with other cases where a function is invoked outside of an explicit object context, this will refer to the global object (window).

- -

The callback function is actually called with three arguments. The first is the value of the current item, the second is its array index, and the third is a reference to the array itself. JavaScript functions ignore any arguments that are not named in the parameter list so it is safe to provide a callback function that only takes a single argument, such as alert.

- - - -

reduce and reduceRight are the least obvious of the iterative array methods. They should be used for algorithms that combine two values recursively in order to reduce a sequence down to a single value.

- -

Multi-Dimensional Arrays

- -

Arrays can be nested, meaning that an array can contain another array as an element. Using this characteristic of JavaScript arrays, multi-dimensional arrays can be created.

- -

The following code creates a two-dimensional array.

- -
var a = new Array(4);
-for (i = 0; i < 4; i++) {
-  a[i] = new Array(4);
-  for (j = 0; j < 4; j++) {
-    a[i][j] = "[" + i + "," + j + "]";
-  }
-}
-
- -

This example creates an array with the following rows:

- -
Row 0: [0,0] [0,1] [0,2] [0,3]
-Row 1: [1,0] [1,1] [1,2] [1,3]
-Row 2: [2,0] [2,1] [2,2] [2,3]
-Row 3: [3,0] [3,1] [3,2] [3,3]
-
- -

Arrays and Regular Expressions

- -

When an array is the result of a match between a regular expression and a string, the array returns properties and elements that provide information about the match. An array is the return value of RegExp.exec(), String.match(), and String.split(). For information on using arrays with regular expressions, see Regular Expressions.

- -

Working with Array-like objects

- -

Some JavaScript objects, such as the NodeList returned by document.getElementsByTagName() or the arguments object made available within the body of a function, look and behave like arrays on the surface but do not share all of their methods. The arguments object provides a length attribute but does not implement the forEach() method, for example.

- -

Array generics, introduced in JavaScript 1.6, provide a way of running Array methods against other array-like objects. Each standard array method has a corresponding method on the Array object itself; for example:

- -
 function alertArguments() {
-   Array.forEach(arguments, function(item) {
-     alert(item);
-   });
- }
-
- -

These generic methods can be emulated more verbosely in older versions of JavaScript using the call method provided by JavaScript function objects:

- -
 Array.prototype.forEach.call(arguments, function(item) {
-   alert(item);
- });
-
- -

Array generic methods can be used on strings as well, since they provide sequential access to their characters in a similar way to arrays:

- -
Array.forEach("a string", function(chr) {
-   alert(chr);
-});
- -

Here are some further examples of applying array methods to strings, also taking advantage of JavaScript 1.8 expression closures:

- -
var str = 'abcdef';
-var consonantsOnlyStr = Array.filter(str, function (c) !(/[aeiou]/i).test(c)).join(''); // 'bcdf'
-var vowelsPresent = Array.some(str, function (c) (/[aeiou]/i).test(c)); // true
-var allVowels = Array.every(str, function (c) (/[aeiou]/i).test(c)); // false
-var interpolatedZeros = Array.map(str, function (c) c+'0').join(''); // 'a0b0c0d0e0f0'
-var numerologicalValue = Array.reduce(str, function (c, c2) c+c2.toLowerCase().charCodeAt()-96, 0);
-// 21 (reduce() since JS v1.8)
-
- -

Note that filter and map do not automatically return the characters back into being members of a string in the return result; an array is returned, so we must use join to return back to a string.

- -

Array comprehensions

- -

Introduced in JavaScript 1.7, array comprehensions provide a useful shortcut for constructing a new array based on the contents of another. Comprehensions can often be used in place of calls to map() and filter(), or as a way of combining the two.

- -

The following comprehension takes an array of numbers and creates a new array of the double of each of those numbers.

- -
var numbers = [1, 2, 3, 4];
-var doubled = [i * 2 for (i of numbers)];
-alert(doubled); // Alerts 2,4,6,8
-
- -

This is equivalent to the following map() operation:

- -
var doubled = numbers.map(function(i){return i * 2;});
-
- -

Comprehensions can also be used to select items that match a particular expression. Here is a comprehension which selects only even numbers:

- -
var numbers = [1, 2, 3, 21, 22, 30];
-var evens = [i for (i of numbers) if (i % 2 === 0)];
-alert(evens); // Alerts 2,22,30
-
- -

filter() can be used for the same purpose:

- -
var evens = numbers.filter(function(i){return i % 2 === 0;});
-
- -

map() and filter() style operations can be combined into a single array comprehension. Here is one that filters just the even numbers, then creates an array containing their doubles:

- -
var numbers = [1, 2, 3, 21, 22, 30];
-var doubledEvens = [i * 2 for (i of numbers) if (i % 2 === 0)];
-alert(doubledEvens); // Alerts 4,44,60
-
- -

The square brackets of an array comprehension introduce an implicit block for scoping purposes. New variables (such as i in the example) are treated as if they had been declared using let. This means that they will not be available outside of the comprehension.

- -

The input to an array comprehension does not itself need to be an array; iterators and generators can also be used.

- -

Even strings may be used as input; to achieve the filter and map actions (under Array-like objects) above:

- -
var str = 'abcdef';
-var consonantsOnlyStr = [c for (c of str) if (!(/[aeiouAEIOU]/).test(c))  ].join(''); // 'bcdf'
-var interpolatedZeros = [c+'0' for (c of str) ].join(''); // 'a0b0c0d0e0f0'
-
- -

Again, the input form is not preserved, so we have to use join() to revert back to a string.

- -

Boolean Object

- -

The Boolean object is a wrapper around the primitive Boolean data type. Use the following syntax to create a Boolean object:

- -
var booleanObjectName = new Boolean(value);
-
- -

Do not confuse the primitive Boolean values true and false with the true and false values of the Boolean object. Any object whose value is not undefined , null, 0, NaN, or the empty string, including a Boolean object whose value is false, evaluates to true when passed to a conditional statement. See if...else Statement for more information.

- -

Date Object

- -

JavaScript does not have a date data type. However, you can use the Date object and its methods to work with dates and times in your applications. The Date object has a large number of methods for setting, getting, and manipulating dates. It does not have any properties.

- -

JavaScript handles dates similarly to Java. The two languages have many of the same date methods, and both languages store dates as the number of milliseconds since January 1, 1970, 00:00:00.

- -

The Date object range is -100,000,000 days to 100,000,000 days relative to 01 January, 1970 UTC.

- -

To create a Date object:

- -
var dateObjectName = new Date([parameters]);
-
- -

where dateObjectName is the name of the Date object being created; it can be a new object or a property of an existing object.

- -

Calling Date without the new keyword simply converts the provided date to a string representation.

- -

The parameters in the preceding syntax can be any of the following:

- - - -

JavaScript 1.2 and earlier
- The Date object behaves as follows:

- - - -

Methods of the Date Object

- -

The Date object methods for handling dates and times fall into these broad categories:

- - - -

With the "get" and "set" methods you can get and set seconds, minutes, hours, day of the month, day of the week, months, and years separately. There is a getDay method that returns the day of the week, but no corresponding setDay method, because the day of the week is set automatically. These methods use integers to represent these values as follows:

- - - -

For example, suppose you define the following date:

- -
var Xmas95 = new Date("December 25, 1995");
-
- -

Then Xmas95.getMonth() returns 11, and Xmas95.getFullYear() returns 1995.

- -

The getTime and setTime methods are useful for comparing dates. The getTime method returns the number of milliseconds since January 1, 1970, 00:00:00 for a Date object.

- -

For example, the following code displays the number of days left in the current year:

- -
var today = new Date();
-var endYear = new Date(1995, 11, 31, 23, 59, 59, 999); // Set day and month
-endYear.setFullYear(today.getFullYear()); // Set year to this year
-var msPerDay = 24 * 60 * 60 * 1000; // Number of milliseconds per day
-var daysLeft = (endYear.getTime() - today.getTime()) / msPerDay;
-var daysLeft = Math.round(daysLeft); //returns days left in the year
-
- -

This example creates a Date object named today that contains today's date. It then creates a Date object named endYear and sets the year to the current year. Then, using the number of milliseconds per day, it computes the number of days between today and endYear, using getTime and rounding to a whole number of days.

- -

The parse method is useful for assigning values from date strings to existing Date objects. For example, the following code uses parse and setTime to assign a date value to the IPOdate object:

- -
var IPOdate = new Date();
-IPOdate.setTime(Date.parse("Aug 9, 1995"));
-
- -

Using the Date Object: an Example

- -

In the following example, the function JSClock() returns the time in the format of a digital clock.

- -
function JSClock() {
-  var time = new Date();
-  var hour = time.getHours();
-  var minute = time.getMinutes();
-  var second = time.getSeconds();
-  var temp = "" + ((hour > 12) ? hour - 12 : hour);
-  if (hour == 0)
-    temp = "12";
-  temp += ((minute < 10) ? ":0" : ":") + minute;
-  temp += ((second < 10) ? ":0" : ":") + second;
-  temp += (hour >= 12) ? " P.M." : " A.M.";
-  return temp;
-}
-
- -

The JSClock function first creates a new Date object called time; since no arguments are given, time is created with the current date and time. Then calls to the getHours, getMinutes, and getSeconds methods assign the value of the current hour, minute, and second to hour, minute, and second.

- -

The next four statements build a string value based on the time. The first statement creates a variable temp, assigning it a value using a conditional expression; if hour is greater than 12, (hour - 12), otherwise simply hour, unless hour is 0, in which case it becomes 12.

- -

The next statement appends a minute value to temp. If the value of minute is less than 10, the conditional expression adds a string with a preceding zero; otherwise it adds a string with a demarcating colon. Then a statement appends a seconds value to temp in the same way.

- -

Finally, a conditional expression appends "P.M." to temp if hour is 12 or greater; otherwise, it appends "A.M." to temp.

- -

Function Object

- -

The predefined Function object specifies a string of JavaScript code to be compiled as a function.

- -

To create a Function object:

- -
var functionObjectName = new Function ([arg1, arg2, ... argn], functionBody);
-
- -

functionObjectName is the name of a variable or a property of an existing object. It can also be an object followed by a lowercase event handler name, such as window.onerror.

- -

arg1, arg2, ... argn are arguments to be used by the function as formal argument names. Each must be a string that corresponds to a valid JavaScript identifier; for example "x" or "theForm".

- -

functionBody is a string specifying the JavaScript code to be compiled as the function body.

- -

Function objects are evaluated each time they are used. This is less efficient than declaring a function and calling it within your code, because declared functions are compiled.

- -

In addition to defining functions as described here, you can also use the function statement and the function expression. See the JavaScript Reference for more information.

- -

The following code assigns a function to the variable setBGColor. This function sets the current document's background color.

- -
var setBGColor = new Function("document.bgColor = 'antiquewhite'");
-
- -

To call the Function object, you can specify the variable name as if it were a function. The following code executes the function specified by the setBGColor variable:

- -
var colorChoice="antiquewhite";
-if (colorChoice=="antiquewhite") {setBGColor()}
-
- -

You can assign the function to an event handler in either of the following ways:

- -
    -
  1. - 
    document.form1.colorButton.onclick = setBGColor;
-
    -
    2. -
  2. - 
    <INPUT NAME="colorButton" TYPE="button"
-  VALUE="Change background color"
-  onClick="setBGColor()">
-
    -
    3. -
- -

Creating the variable setBGColor shown above is similar to declaring the following function:

- -
function setBGColor() {
-  document.bgColor = 'antiquewhite';
-}
-
- -

Assigning a function to a variable is similar to declaring a function, but there are differences:

- - - -

You can nest a function within a function. The nested (inner) function is private to its containing (outer) function:

- - - -

Math Object

- -

The predefined Math object has properties and methods for mathematical constants and functions. For example, the Math object's PI property has the value of pi (3.141...), which you would use in an application as

- -
Math.PI
-
- -

Similarly, standard mathematical functions are methods of Math. These include trigonometric, logarithmic, exponential, and other functions. For example, if you want to use the trigonometric function sine, you would write

- -
Math.sin(1.56)
-
- -

Note that all trigonometric methods of Math take arguments in radians.

- -

The following table summarizes the Math object's methods.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Table 7.1 Methods of Math
MethodDescription
absAbsolute value
sin, cos, tanStandard trigonometric functions; argument in radians
acos, asin, atan, atan2Inverse trigonometric functions; return values in radians
exp, logExponential and natural logarithm, base e
ceilReturns least integer greater than or equal to argument
floorReturns greatest integer less than or equal to argument
min, maxReturns greater or lesser (respectively) of two arguments
powExponential; first argument is base, second is exponent
randomReturns a random number between 0 and 1.
roundRounds argument to nearest integer
sqrtSquare root
- -

Unlike many other objects, you never create a Math object of your own. You always use the predefined Math object.

- -

Number Object

- -

The Number object has properties for numerical constants, such as maximum value, not-a-number, and infinity. You cannot change the values of these properties and you use them as follows:

- -
var biggestNum = Number.MAX_VALUE;
-var smallestNum = Number.MIN_VALUE;
-var infiniteNum = Number.POSITIVE_INFINITY;
-var negInfiniteNum = Number.NEGATIVE_INFINITY;
-var notANum = Number.NaN;
-
- -

You always refer to a property of the predefined Number object as shown above, and not as a property of a Number object you create yourself.

- -

The following table summarizes the Number object's properties.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Table 7.2 Properties of Number
PropertyDescription
MAX_VALUEThe largest representable number
MIN_VALUEThe smallest representable number
NaNSpecial "not a number" value
NEGATIVE_INFINITYSpecial negative infinite value; returned on overflow
POSITIVE_INFINITYSpecial positive infinite value; returned on overflow
- -

The Number prototype provides methods for retrieving information from Number objects in various formats. The following table summarizes the methods of Number.prototype.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Table 7.3 Methods of Number.prototype
MethodDescription
toExponentialReturns a string representing the number in exponential notation.
toFixedReturns a string representing the number in fixed-point notation.
toPrecisionReturns a string representing the number to a specified precision in fixed-point notation.
toSourceReturns an object literal representing the specified Number object; you can use this value to create a new object. Overrides the Object.toSource method.
toStringReturns a string representing the specified object. Overrides the Object.toString method.
valueOfReturns the primitive value of the specified object. Overrides the Object.valueOf method.
- -

RegExp Object

- -

The RegExp object lets you work with regular expressions. It is described in Regular Expressions.

- -

String Object

- -

The String object is a wrapper around the string primitive data type. Do not confuse a string literal with the String object. For example, the following code creates the string literal s1 and also the String object s2:

- -
var s1 = "foo"; //creates a string literal value
-var s2 = new String("foo"); //creates a String object
-
- -

You can call any of the methods of the String object on a string literal value—JavaScript automatically converts the string literal to a temporary String object, calls the method, then discards the temporary String object. You can also use the String.length property with a string literal.

- -

You should use string literals unless you specifically need to use a String object, because String objects can have counterintuitive behavior. For example:

- -
var s1 = "2 + 2"; //creates a string literal value
-var s2 = new String("2 + 2"); //creates a String object
-eval(s1); //returns the number 4
-eval(s2); //returns the string "2 + 2"
- -

A String object has one property, length, that indicates the number of characters in the string. For example, the following code assigns x the value 13, because "Hello, World!" has 13 characters:

- -
var mystring = "Hello, World!";
-var x = mystring.length;
-
- -

A String object has two types of methods: those that return a variation on the string itself, such as substring and toUpperCase, and those that return an HTML-formatted version of the string, such as bold and link.

- -

For example, using the previous example, both mystring.toUpperCase() and "hello, world!".toUpperCase() return the string "HELLO, WORLD!"

- -

The substring method takes two arguments and returns a subset of the string between the two arguments. Using the previous example, mystring.substring(4, 9) returns the string "o, Wo". See the substring method of the String object in the JavaScript Reference for more information.

- -

The String object also has a number of methods for automatic HTML formatting, such as bold to create boldface text and link to create a hyperlink. For example, you could create a hyperlink to a hypothetical URL with the link method as follows:

- -
mystring.link("http://www.helloworld.com")
-
- -

The following table summarizes the methods of String objects.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Table 7.4 Methods of String Instances
MethodDescription
anchorCreates HTML named anchor.
big, blink, bold, fixed, italics, small, strike, sub, supCreate HTML formatted string.
charAt, charCodeAtReturn the character or character code at the specified position in string.
indexOf, lastIndexOfReturn the position of specified substring in the string or last position of specified substring, respectively.
linkCreates HTML hyperlink.
concatCombines the text of two strings and returns a new string.
fromCharCodeConstructs a string from the specified sequence of Unicode values. This is a method of the String class, not a String instance.
splitSplits a String object into an array of strings by separating the string into substrings.
sliceExtracts a section of an string and returns a new string.
substring, substrReturn the specified subset of the string, either by specifying the start and end indexes or the start index and a length.
match, replace, searchWork with regular expressions.
toLowerCase, toUpperCase -

Return the string in all lowercase or all uppercase, respectively.

-
- -

autoPreviousNext("JSGChapters")

diff --git a/files/ru/web/javascript/guide/using_promises/index.html b/files/ru/web/javascript/guide/using_promises/index.html new file mode 100644 index 0000000000..a910dfca09 --- /dev/null +++ b/files/ru/web/javascript/guide/using_promises/index.html @@ -0,0 +1,321 @@ +--- +title: Использование промисов +slug: Web/JavaScript/Guide/Ispolzovanie_promisov +tags: + - JavaScript + - Асинхронность + - Гайд + - промис +translation_of: Web/JavaScript/Guide/Using_promises +--- +
+

{{jsSidebar("Руководство по JavaScript")}}{{PreviousNext("Web/JavaScript/Guide/Details_of_the_Object_Model", "Web/JavaScript/Guide/Iterators_and_Generators")}}

+
+ +

{{jsxref("Promise")}} (промис, англ. "обещание") - это объект, представляющий результат успешного или неудачного завершения асинхронной операции. Так как большинство людей пользуются уже созданными промисами, это руководство начнем с объяснения использования вернувшихся промисов до объяснения принципов создания. 

+ +

В сущности, промис - это возвращаемый объект, в который вы записываете два коллбэка вместо того, чтобы передать их функции.

+ +

Например, вместо старомодной функции, которая принимает два коллбэка и вызывает один из них в зависимости от успешного или неудачного завершения операции:

+ +
function doSomethingOldStyle(successCallback, failureCallback) {
+  console.log("Готово.");
+  // Успех в половине случаев.
+  if (Math.random() > .5) {
+    successCallback("Успех")
+  } else {
+    failureCallback("Ошибка")
+  }
+}
+
+function successCallback(result) {
+  console.log("Успешно завершено с результатом " + result);
+}
+
+function failureCallback(error) {
+  console.log("Завершено с ошибкой " + error);
+}
+
+doSomethingOldStyle(successCallback, failureCallback);
+
+ +

…современные функции возвращают промис, в который вы записываете ваши коллбэки:

+ +
function doSomething() {
+  return new Promise((resolve, reject) => {
+    console.log("Готово.");
+    // Успех в половине случаев.
+    if (Math.random() > .5) {
+      resolve("Успех")
+    } else {
+      reject("Ошибка")
+    }
+  })
+}
+
+const promise = doSomething();
+promise.then(successCallback, failureCallback);
+ +

…или просто:

+ +
doSomething().then(successCallback, failureCallback);
+ +

Мы называем это асинхронным вызовом функции. У этого соглашения есть несколько преимуществ. Давайте рассмотрим их.

+ +

Гарантии

+ +

В отличие от старомодных переданных коллбэков промис дает некоторые гарантии:

+ + + +

Но наиболее непосредственная польза от промисов - цепочка вызовов (chaining).

+ +

Цепочка вызовов

+ +

Общая нужда - выполнять две или более асинхронных операции одна за другой, причём каждая следующая начинается при успешном завершении предыдущей и использует результат её выполнения. Мы реализуем это, создавая цепочку вызовов промисов (promise chain).

+ +

Вот в чём магия: функция then возвращает новый промис, отличающийся от первоначального:

+ +
let promise = doSomething();
+let promise2 = promise.then(successCallback, failureCallback);
+
+ +

или

+ +
let promise2 = doSomething().then(successCallback, failureCallback);
+
+ +

Второй промис представляет завершение не только doSomething(), но и функций successCallback или failureCallback, переданных Вами, а они тоже могут быть асинхронными функциями, возвращающими промис. В этом случае все коллбэки, добавленные к promise2 будут поставлены в очередь за промисом, возвращаемым successCallback или failureCallback.

+ +

По сути, каждый вызванный промис означает успешное завершение предыдущих шагов в цепочке.

+ +

Раньше выполнение нескольких асинхронных операций друг за другом приводило к классической "Вавилонской башне" коллбэков:

+ +
doSomething(function(result) {
+  doSomethingElse(result, function(newResult) {
+    doThirdThing(newResult, function(finalResult) {
+      console.log('Итоговый результат: ' + finalResult);
+    }, failureCallback);
+  }, failureCallback);
+}, failureCallback);
+
+ +

В современных функциях мы записываем коллбэки в возвращаемые промисы - формируем цепочку промисов:

+ +
doSomething().then(function(result) {
+  return doSomethingElse(result);
+})
+.then(function(newResult) {
+  return doThirdThing(newResult);
+})
+.then(function(finalResult) {
+  console.log('Итоговый результат: ' + finalResult);
+})
+.catch(failureCallback);
+
+ +

Аргументы then необязательны, а catch(failureCallback) - это сокращение для then(null, failureCallback). Вот как это выражено с помощью стрелочных функций:

+ +
doSomething()
+.then(result => doSomethingElse(result))
+.then(newResult => doThirdThing(newResult))
+.then(finalResult => {
+  console.log(`Итоговый результат: ${finalResult}`);
+})
+.catch(failureCallback);
+
+ +

Важно: Всегда возвращайте промисы в return, иначе коллбэки не будут сцеплены и ошибки могут быть не пойманы (стрелочные функции неявно возвращают результат, если скобки {} вокруг тела функции опущены).

+ +

Цепочка вызовов после catch

+ +

Можно продолжить цепочку вызовов после ошибки, т. е. после catch, что полезно для выполнения новых действий даже после того, как действие вернет ошибку в цепочке вызовов. Ниже приведен пример:

+ +
new Promise((resolve, reject) => {
+    console.log('Начало');
+
+    resolve();
+})
+.then(() => {
+    throw new Error('Где-то произошла ошибка');
+
+    console.log('Выведи это');
+})
+.catch(() => {
+    console.log('Выведи то');
+})
+.then(() => {
+    console.log('Выведи это, несмотря ни на что');
+});
+ +

В результате выведется данный текст:

+ +
Начало
+Выведи то
+Выведи это, несмотря ни на что
+ +

Заметьте, что текст "Выведи это" не вывелся, потому что "Где то произошла ошибка" привела к отказу

+ +

Распространение ошибки

+ +

Вы могли ранее заметить, что failureCallback  повторяется три раза  в "pyramid of doom", а в цепочке промисов всего лишь один раз:

+ +
doSomething()
+.then(result => doSomethingElse(result))
+.then(newResult => doThirdThing(newResult))
+.then(finalResult => console.log(`Итоговый результат: ${finalResult}`))
+.catch(failureCallback);
+ +

В основном, цепочка промисов останавливает выполнение кода, если где-либо произошла ошибка, и вместо этого ищет далее по цепочке обработчики ошибок. Это очень похоже на то, как работает синхронный код:

+ +
try {
+  let result = syncDoSomething();
+  let newResult = syncDoSomethingElse(result);
+  let finalResult = syncDoThirdThing(newResult);
+  console.log(`Итоговый результат: ${finalResult}`);
+} catch(error) {
+  failureCallback(error);
+}
+
+ +

Эта симметрия с синхронным кодом лучше всего показывает себя в синтаксическом сахаре async/await в ECMAScript 2017:

+ +
async function foo() {
+  try {
+    let result = await doSomething();
+    let newResult = await doSomethingElse(result);
+    let finalResult = await doThirdThing(newResult);
+    console.log(`Итоговый результат: ${finalResult}`);
+  } catch(error) {
+    failureCallback(error);
+  }
+}
+
+ +

Работа данного кода основана на промисах. Для примера здесь используется функция doSomething(), которая встречалась ранее. Вы можете прочитать больше о синтаксисе здесь

+ +

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

+ +

Создание промиса вокруг старого коллбэка

+ +

{{jsxref("Promise")}} может быть создан с помощью конструктора. Это может понадобится только для старых API.

+ +

В идеале, все асинхронные функции уже должны возвращать промис. Но увы, некоторые APIs до сих пор ожидают успешного или неудачного  коллбека переданных по старинке. Типичный пример: {{domxref("WindowTimers.setTimeout", "setTimeout()")}} функция:

+ +
setTimeout(() => saySomething("10 seconds passed"), 10000);
+ +

Смешивание старого коллбэк-стиля и промисов проблематично. В случае неудачного завершения saySomething или программной ошибки, нельзя обработать ошибку.

+ +

К с частью мы можем обернуть функцию в промис. Хороший тон оборачивать проблематичные функции на самом низком возможном уровне, и больше никогда их не вызывать на прямую:

+ +
const wait = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+wait(10000).then(() => saySomething("10 seconds")).catch(failureCallback);
+ +

В сущности, конструктор промиса становится исполнителем функции, который позволяет нам резолвить или режектить промис вручную. Так как setTimeout всегда успешен, мы опустили reject в этом случае.

+ +

Композиция

+ +

{{jsxref("Promise.resolve()")}} и {{jsxref("Promise.reject()")}} короткий способ создать уже успешные или отклоненные промисы соответственно. Это иногда бывает полезно.

+ +

{{jsxref("Promise.all()")}} и {{jsxref("Promise.race()")}} - два метода запустить асинхронные операции параллельно.

+ +

Последовательное выполнение композиции возможно при помощи хитрости JavaScript:

+ +
[func1, func2].reduce((p, f) => p.then(f), Promise.resolve());
+ +

Фактически, мы превращаем массив асинхронных функций в цепочку промисов равносильно: Promise.resolve().then(func1).then(func2);

+ +

Это также можно сделать, объеденив композицию в функцию, в функциональном стиле программирования:

+ +
const applyAsync = (acc,val) => acc.then(val);
+const composeAsync = (...funcs) => x => funcs.reduce(applyAsync, Promise.resolve(x));
+ +

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

+ +
const transformData = composeAsync(func1, asyncFunc1, asyncFunc2, func2);
+transformData(data);
+ +

В ECMAScript 2017, последовательные композиции могут быть выполненны более простым способом с помощью async/await:

+ +
for (const f of [func1, func2]) {
+  await f();
+}
+ +

Порядок выполнения

+ +

Чтобы избежать сюрпризов, функции, переданные в then никогда не будут вызванны синхронно, даже с уже разрешенным промисом:

+ +
Promise.resolve().then(() => console.log(2));
+console.log(1); // 1, 2
+ +

Вместо немедленного выполнения, переданная функция встанет в очередь микрозадач, а значит выполнится, когда очередь будет пустой  в конце текущего вызова JavaScript цикла событий (event loop), т.е. очень скоро:

+ +
const wait = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+wait().then(() => console.log(4));
+Promise.resolve().then(() => console.log(2)).then(() => console.log(3));
+console.log(1); // 1, 2, 3, 4
+ +

Вложенность

+ +

Простые цепочки promise лучше оставлять без вложений, так как вложеность может быть результатом небрежной структуры. Смотрите распространенные ошибки.

+ +

Вложенность - это управляющая структура, ограничивающая область действия операторов catch. В частности, вложенный catch только перехватывает сбои в своей области и ниже, а не ошибки выше в цепочке за пределами вложенной области. При правильном использовании это дает большую точность в извлечение ошибок:

+ +
doSomethingCritical()
+.then(result => doSomethingOptional()
+  .then(optionalResult => doSomethingExtraNice(optionalResult))
+  .catch(e => {})) // Игнорируется если необязательные параметр не выкинул исключение
+.then(() => moreCriticalStuff())
+.catch(e => console.log("Критическая ошибка: " + e.message));
+ +

Обратите внимание, что необязательный шаги здесь выделены отступом.

+ +

Внутренний оператор catch нейтрализует и перехватывает ошибки только от doSomethingOptional() и doSomethingExtraNice(), после чего код возобновляется с помощью moreCriticalStuff(). Важно, что в случае сбоя doSomethingCritical() его ошибка перехватывается только последним (внешним) catch.

+ +

Частые ошибки

+ +

В этом разделе собраны частые ошибки, возникающие при создании цепочек обещаний. Несколько таких ошибок можно увидеть в следующем примере:

+ +
// Плохой пример! Три ошибки!
+
+doSomething().then(function(result) {
+  doSomethingElse(result) // Забыл вернуть обещание из внутренней цепочки + неуместное влаживание
+  .then(newResult => doThirdThing(newResult));
+}).then(() => doFourthThing());
+// Забыл закончить цепочку методом catch
+ +

Первая ошибка это неправильно сцепить вещи между собой. Такое происходит когда мы создаем промис но забываем вернуть его. Как следствие, цепочка сломана, но правильнее было бы сказать что теперь у нас есть две независимые цепочки, соревнующиеся за право разрешится первой. Это означает doFourthThing() не будет ждать doSomethingElse() или doThirdThing() пока тот закончится, и будет исполнятся параллельно с ними, это ,вероятно, не то что хотел разработчик. Отдельные цепочки также имеют отдельную обработку ошибок, что приводит к необработанным ошибкам.

+ +

Вторая ошибка это излишняя вложенность, включая первую ошибку. Вложенность также ограничивает область видимости внутренних обработчиков ошибок, если это не то чего хотел разработчик, это может привести к необработанным ошибкам. Примером этого является пример как не нужно создавать обещания, который комбинирует вложенность с чрезмерным использованием конструктора обещаний для оборачивания кода который уже использует промисы.

+ +

Третяя ошибка это забыть закончить цепочку ключевым словом catch. Незаконченные цепочки приводят к необработанным отторжениям обещаний в большинстве браузеров.

+ +

Хорошим примером является всегда либо возвращать либо заканчивать цепочки обещаний, и как только вы получаете новое обещание, возвращайте его сразу же, чтобы не усложнять код излишней вложенностью:

+ +
doSomething()
+.then(function(result) {
+  return doSomethingElse(result);
+})
+.then(newResult => doThirdThing(newResult))
+.then(() => doFourthThing())
+.catch(error => console.log(error));
+ +

Обратите внимание что () => x  это сокращенная форма () => { return x; }.

+ +

Теперь у нас имеется единственная определенная цепочка с правильной обработкой ошибок.

+ +

Использование async/await предотвращает большинство, если не все вышеуказанные ошибки—но взамен появляется другая частая ошибка—забыть ключевое слово await.

+ +

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

+ + diff --git "a/files/ru/web/javascript/guide/\320\262\320\262\320\265\320\264\320\265\320\275\320\270\320\265_\320\262_javascript/index.html" "b/files/ru/web/javascript/guide/\320\262\320\262\320\265\320\264\320\265\320\275\320\270\320\265_\320\262_javascript/index.html" deleted file mode 100644 index 1b49c45ddb..0000000000 --- "a/files/ru/web/javascript/guide/\320\262\320\262\320\265\320\264\320\265\320\275\320\270\320\265_\320\262_javascript/index.html" +++ /dev/null @@ -1,159 +0,0 @@ ---- -title: Введение в JavaScript -slug: Web/JavaScript/Guide/Введение_в_JavaScript -tags: - - Beginner - - Guide - - JavaScript -translation_of: Web/JavaScript/Guide/Introduction ---- -

{{jsSidebar("JavaScript Guide")}} {{PreviousNext("Web/JavaScript/Guide", "Web/JavaScript/Guide/Values,_variables,_and_literals")}}

- -
-

Данная глава является введением в JavaScript и рассматривает некоторые его фундаментальные концепции.

-
- -

Что вам уже следует знать?

- -

В данном руководстве предполагается, что вы имеете:

- - - -

Где можно найти информацию о JavaScript?

- -

Документация по JavaScript на MDN включает:

- - - -

Если вы являетесь новичком в JavaScript, то начните с Изучение Web и Руководство по JavaScript. Как только вы освоите фундаментальные концепции, используйте Справочник по JavaScript для того, чтобы получить более подробную информацию о конкретных объектах или операторах.

- -

Что такое JavaScript?

- -

JavaScript — это кросс-платформенный, объектно-ориентированный скриптовый язык, являющийся небольшим и легковесным. Внутри среды исполнения JavaScript может быть связан с объектами данной среды и предоставлять программный контроль над ними.

- -

JavaScript включает стандартную библиотеку объектов, например, Array, Date и Math, а также базовый набор языковых элементов, например, операторы и управляющие конструкции. Ядро JavaScript может быть расширено для различных целей путем добавления в него новых объектов, например:

- - - -

JavaScript и Java

- -

JavaScript и Java похожи в одних отношениях, но фундаментально отличны в других. Javascript напоминает Java, но не имеет статической типизации и строгой проверки типов, которыми обладает Java. JavaScript следует большей части синтаксиса Java в выражениях, соглашениях об именовании и основного потока управления конструкциями, поэтому он был переименован из LiveScript в JavaScript.

- -

В отличие от системы скомпилированных классов Java, построенной на объявлениях, JavaScript поддерживает систему исполнения, основанную на небольшом числе типов данных, представляющих числовые, логические и строковые значения. JavaScript имеет объектную модель на базе прототипов вместо более общей модели на базе классов. Модель объектов на базе прототипов предоставляет динамическое наследование, т.е. то, что наследуется, может отличаться для отдельных объектов. JavaScript также поддерживает функции без каких-либо специальных декларативных требований. Функции могут быть свойствами объектов, выполняться как свободно-типизированные методы.

- -

По сравнению с Java, JavaScript является языком с очень свободной формой. Вам не надо объявлять переменные, классы и методы. Вам не надо беспокоиться о том, являются ли методы публичными (public), приватными (private) или защищенными (protected), а также вам не надо реализовывать интерфейсы. Переменные, параметры и возвращаемые функциями типы не являются явно типизированными.

- -

Java — это язык программирования, основанный на классах и предназначенный для быстрого выполнения и безопасности типов. Безопасность типов означает, например, что вы не можете привести тип integer к типу object reference или получить доступ к приватной памяти, изменяя байт-код Java. Ориентированная на классы модель Java означает, что программы состоят исключительно из классов и их методов. Наследование классов и строгая типизация в Java обычно требуют тесно связанные иерархии объектов. Эти требования делают программирование на Java более комплексным, чем программирование на JavaScript.

- -

По духу JavaScript происходит от небольших, динамически типизированных языков, таких как HyperTalk и dBASE. Эти скриптовые языки предлагают инструменты программирования для гораздо более широкой аудитории благодаря более простому синтаксису, специализированной встроенной функциональности и минимальным требованиям для создания объектов.

- - - - - - - - - - - - - - - - - - - - - - - -
Сравнение JavaScript и Java
JavaScriptJava
Объектно-ориентированный. Нет различий между типами объектов. Наследование реализовано через механизм прототипов, свойства и методы могут быть добавлены в любой объект динамически.На базе классов. Объекты делятся на классы и экземпляры с наследованием через классовую иерархию. Классы и экземпляры не могут иметь динамически добавленные свойства или методы.
Типы данных переменных не объявляются (динамическая типизация).Типы данных переменных должны быть объявлены (статическая типизация).
Не может автоматически записывать на жесткий диск.Может автоматически записывать на жесткий диск.
- -

Для получения дополнительной информации о различиях между JavaScript и Java, прочитайте Details of the object model.

- -

JavaScript и спецификация ECMAScript

- -

JavaScript стандартизирован европейской ассоциацией Ecma International, деятельность которой посвящена стандартизации информационных и коммуникационных систем (изначально ECMA являлся акронимом European Computer Manufacturers Association). Эта стандартизированная версия JavaScript, называемая ECMAScript, работает одинаково во всех приложениях, поддерживающих стандарт. Компании могут использовать открытый стандарт языка, чтобы разработать собственную реализацию JavaScript. Стандарт ECMAScript задокументирован в спецификации ECMA-262. Чтобы узнать больше информации о разных версиях JavaScript и ECMAScript, прочитайте Что нового в JavaScript.

- -

Стандарт ECMA-262 также утвержден ISO (International Organization for Standardization) как ISO-16262. Вы можете найти спецификацию на сайте Ecma International. Спецификация ECMAScript не описывает Document Object Model (DOM), которая стандартизирована World Wide Web Consortium (W3C). DOM определяет способ для доступа к объектам HTML документа из вашего скрипта. Чтобы получить более точное представление о различных технологиях, используемых при программировании на JavaScript, прочитайте Обзор JavaScript.

- -

Документация JavaScript против спецификации ECMAScript

- -

Спецификация ECMAScript — это набор требований, касающихся реализации ECMAScript. Она предназначена для реализации языковых возможностей, соответствующих стандарту, в вашей реализации ECMAScript или движке (например, SpiderMonkey в Firefox или V8 в Google Chrome).

- -

Документ ECMAScript не предназначен для помощи программистам в создании скриптов; чтобы получить информацию о том, как писать скрипты, используйте документацию JavaScript.

- -

Спецификация ECMAScript использует терминологию и синтаксис, которые могут быть незнакомы JavaScript-программистам. Хотя описание языка может отличаться в ECMAScript, но сам язык остается таким же. JavaScript поддерживает всю функциональность, описанную в спецификации ECMAScript.

- -

Документация JavaScript описывает аспекты языка, являющиеся подходящими для JavaScript-программиста.

- -

Начинаем знакомство с JavaScript

- -

Все, что вам нужно для знакомства с JavaScript — это современный браузер. Данное руководство включает некоторые возможности JavaScript, которые на данный момент доступны только в последних версиях Firefox, поэтому рекомендуется использовать последнюю версию Firefox.

- -

В Firefox встроены два инструмента, полезных для экспериментирования с JavaScript: Web Console и Scratchpad.

- -

Web Console

- -

Web Console отображает информацию о текущей загруженной веб-странице, а также включает командную строку, которую вы можете использовать, чтобы выполнить выражения JavaScript на текущей странице.

- -

Чтобы открыть Web Console, выберите "Web Console" из меню "Web Developer", которое находится под меню "Tools" в Firefox. Консоль появится в нижней части окна браузера. Вдоль нижней части консоли размещается командная строка, которую вы можете использовать для ввода JavaScript, результат выполнения появится на панели выше:

- -

- - - -
function greetMe(yourName) {
-  alert('Hello ' + yourName);
-}
-console.log(eval('3 + 5'));
- - - -

Scratchpad

- -

Web Console отлично подходит для выполнения одиночных строк JavaScript, но хотя вы можете выполнить и несколько строк, это не очень удобно, к тому же вы не можете сохранить ваш код, используя Web Console. Поэтому для более комплексных примеров Scratchpad является более подходящим инструментом.

- -

Чтобы открыть Scratchpad(Shift+F4), выберите "Scratchpad" из меню "Web Developer", которое находится под меню "Tools" в Firefox. Блокнот будет открыт в отдельном окне, вы можете использовать его для создания и выполнения JavaScript в браузере. Вы также можете сохранять ваши скрипты на жесткий диск, а потом загружать их.

- -

Если вы выберете "Display", то код в вашем блокноте будет выполнен в браузере, а результат вставлен обратно в блокнот как комментарий:

- -

- -

Hello world

- -

Чтобы начать писать JavaScript код откройте Scratchpad и напишите свой первый "Hello World!" код:

- -
(function(){
-  "use strict";
-  /* Start of your code */
-  function greetMe(yourName) {
-    alert('Hello ' + yourName);
-  }
-
-  greetMe('World');
-  /* End of your code */
-})();
- -

Выберите код на панели и зажмите Ctrl + R, чтобы открыть код в браузере! На следующих страницах мы изучим синтаксис  и возможности JS, чтобы вы могли написать сложное более сложное приложение. Не забывайте добавлять перед кодом (function(){"use strict"; и })();  после. вы узнаете, что это означает, а пока считайте, что это —

- -

1.  Значительно улучшает производительность

- -

2.  Предотвращает структуры, которые могут запутать вас на начальном этапе.

- -

3.  Предотвращает взаимодействие фрагментов кода, выполняемых в консоли.

- -

{{PreviousNext("Web/JavaScript/Guide", "Web/JavaScript/Guide/Grammar_and_types")}}

diff --git "a/files/ru/web/javascript/guide/\320\276\320\261_\321\215\321\202\320\276\320\274_\321\200\321\203\320\272\320\276\320\262\320\276\320\264\321\201\321\202\320\262\320\265/index.html" "b/files/ru/web/javascript/guide/\320\276\320\261_\321\215\321\202\320\276\320\274_\321\200\321\203\320\272\320\276\320\262\320\276\320\264\321\201\321\202\320\262\320\265/index.html" deleted file mode 100644 index 397327911c..0000000000 --- "a/files/ru/web/javascript/guide/\320\276\320\261_\321\215\321\202\320\276\320\274_\321\200\321\203\320\272\320\276\320\262\320\276\320\264\321\201\321\202\320\262\320\265/index.html" +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Об этом руководстве -slug: Web/JavaScript/Guide/Об_этом_руководстве ---- -

 

-

JavaScript является кросс-платформенным, объектно-ориентированный язык сценариев. Это руководство объясняет все, что нужно знать об использовании JavaScript.

-

Новые возможности в версиях JavaScript

-
/* Note: To add a link to new JavaScript version description
-add version number to versionList variable below. The page linked to
-must reside in /en/JavaScript/New_in_JavaScript/N, where N is version number. */
-
-var versionList = ["1.5", "1.6", "1.7", "1.8", "1.8.1", "1.8.5"];
-var s = "";
-<ul>
-  foreach (var i in versionList){
-    let s = "/en/JavaScript/New_in_JavaScript/" .. i;
-    <li>web.link(s, wiki.getPage(s).title)</li>;
-  }
-</ul>;
-
-

То, что вы должны уже знать

-

This guide assumes you have the following basic background:

- -

Некоторый опыт программирования на языках, таких как C или Visual Basic, полезен, но не обязателен.

-

Версии JavaScript

- -
Таблица №1 версии JavaScript и веб-браузера Navigator
JavaScript version Navigator version
JavaScript 1.0 Navigator 2.0
JavaScript 1.1 Navigator 3.0
JavaScript 1.2 Navigator 4.0-4.05
JavaScript 1.3 Navigator 4.06-4.7x
JavaScript 1.4  
JavaScript 1.5 Navigator 6.0
Mozilla (браузер с открытым исходным кодом)
JavaScript 1.6 Firefox 1.5, other Mozilla 1.8-based products
JavaScript 1.7 Firefox 2, other Mozilla 1.8.1-based products
JavaScript 1.8 Firefox 3, other Gecko 1.9-based products
-

 

-
Каждая версия Netscape Enterprise Server, также поддерживает различные версии JavaScript. Чтобы помочь вам писать сценарии, которые совместимы с несколькими версиями Enterprise Server, это руководство использует аббревиатуру для обозначения версии сервера, в котором каждая функция была реализована.
-
- -
Таблица №2 Аббревиатуры в версиях Netscape Enterprise Server
Аббревиатура Версия Server Enterprise
NES 2.0 Netscape Enterprise Server 2.0
NES 3.0 Netscape Enterprise Server 3.0
-

Где найти информацию о JavaScript

-

JavaScript документация включает в себя следующие книги:

- -

Если вы новичок в JavaScript, начните с руководства JavaScript. Если у вас есть твердое понимание основы, вы можете использовать Справочник по JavaScript чтобы получить более подробную информацию на отдельных объектах и ​​операторах.

-

Советы для изучения JavaScript

-

Начало работы с JavaScript очень просто: все, что вам нужно, это современный веб-браузер. Это руководство включает в себя некоторые функции JavaScript, которые только в настоящее время доступна в последней версии Firefox (и других браузеров с движком Gecko), поэтому рекомендуется использование самых последних версий Firefox.

-

Интерактивный интерпретатор

-

Диалоговый JavaScript незамедлительно - неоценимая помощь изучению языка, так как это предоставляет вам возможность пробовать вещи в интерактивном режиме без необходимости сохранить файл и обновить страницу. Ошибочная Консоль Firefox, доступная через меню Инструменты, обеспечивает простой путь пробовать диалоговый JavaScript: Только вводят линию кода и щелкают кнопку "Evaluate".

-

Image:ErrorConsole.png

-

Firebug

-

Более передовой диалоговый незамедлительно - доступный использующий Firebug, дополнение к Firefox. Выражения, которые вы печатаете, интерпретируются как объекты и связанные с другими частями Firebug. Например, вы можете добавить 5 плюс 5, изменять регистр строки, get a clickable link to the document, or get a link to an element:

-

-

Использование стрелки на правом нижнем углу дает команду редактор для многострочного сценариев.

-

Firebug also provides an advanced DOM inspector, a JavaScript debugger, a profiling tool and various other utilities. JavaScript code running in a Web page can call, console.log(), a function that prints its arguments to the Firebug console.

-

Many of the examples in this guide use alert() to show messages as they execute. If you have Firebug installed you can use console.log() in place of alert() when running these examples.

-

Document conventions

-

JavaScript applications run on many operating systems; the information in this book applies to all versions. File and directory paths are given in Windows format (with backslashes separating directory names). For Unix versions, the directory paths are the same, except that you use slashes instead of backslashes to separate directories.

-

This guide uses uniform resource locators (URLs) of the following form:

-

http://server.domain/path/file.html

-

In these URLs, server represents the name of the server on which you run your application, such as research1 or www; domain represents your Internet domain name, such as netscape.com or uiuc.edu; path represents the directory structure on the server; and file.html represents an individual file name. In general, items in italics in URLs are placeholders and items in normal monospace font are literals. If your server has Secure Sockets Layer (SSL) enabled, you would use https instead of http in the URL.

-

This guide uses the following font conventions:

- -
autoPreviousNext("JSGChapters");
-wiki.languages({
-  "zh-tw": "zh_tw/Core_JavaScript_1.5_教學/關於",
-  "es": "es/Gu\u00eda_JavaScript_1.5/Acerca_de_esta_gu\u00eda",
-  "fr": "fr/Guide_JavaScript_1.5/\u00c0_propos",
-  "ja": "ja/Core_JavaScript_1.5_Guide/About",
-  "ko": "ko/Core_JavaScript_1.5_Guide/About",
-  "pl": "pl/Przewodnik_po_j\u0119zyku_JavaScript_1.5/O_tym_przewodniku",
-  "zh-cn": "cn/Core_JavaScript_1.5_Guide/\u5173\u4e8e"
-})
-
diff --git "a/files/ru/web/javascript/guide/\321\206\320\270\320\272\320\273\321\213_\320\270_\320\270\321\202\320\265\321\200\320\260\321\206\320\270\320\270/index.html" "b/files/ru/web/javascript/guide/\321\206\320\270\320\272\320\273\321\213_\320\270_\320\270\321\202\320\265\321\200\320\260\321\206\320\270\320\270/index.html" deleted file mode 100644 index 231bc70804..0000000000 --- "a/files/ru/web/javascript/guide/\321\206\320\270\320\272\320\273\321\213_\320\270_\320\270\321\202\320\265\321\200\320\260\321\206\320\270\320\270/index.html" +++ /dev/null @@ -1,362 +0,0 @@ ---- -title: Циклы и итерации -slug: Web/JavaScript/Guide/Циклы_и_итерации -tags: - - for - - операторы цикла - - циклы -translation_of: Web/JavaScript/Guide/Loops_and_iteration ---- -
{{jsSidebar("JavaScript Guide")}} {{PreviousNext("Web/JavaScript/Guide/Control_flow_and_error_handling", "Web/JavaScript/Guide/Functions")}}
- -

Циклы - простой способ сделать какое-то действие несколько раз. Эта глава руководства JavaScript Guide познакомит вас с различными операторами доступными в JavaScript.

- -

Вы можете представить цикл в виде компьютеризированной версии игры, где вы говорите кому-то сделать X шагов в одном направлении, затем Y шагов в другом; для примера, идея игры "Иди 5 шагов на восток" может быть выражена в виде цикла:

- -
var step;
-for (step = 0; step < 5; step++) {
-  // Запускается 5 раз, с шагом от 0 до 4.
-  console.log('Идём 1 шаг на восток');
-}
-
- -

Существует множество различных видов циклов, но все они по сути делают тоже самое: повторяют какое-либо действие несколько раз (не забывайте про нулевой раз повторения, отсчёт в массиве начинается с 0). Различные по строению циклы предлагают разные способы для определения начала и окончания цикла. Для различных задач программирования существуют свои операторы цикла, с помощью которых они решаются намного проще.

- -

Операторы предназначеные для организации циклов в  JavaScript:

- - - -

Цикл for 

- -

Цикл for  повторяет действия, пока не произойдёт какое-либо специальное событие завершения цикла. Оператор for в JavaScript аналогичен оператору for в Java и C. Объявление оператора for выглядит следующим образом:

- -
for ([начало]; [условие]; [шаг]) выражения
-
- -

При его выполнении происходит следущее:

- -
    -
  1. Выполняется выражение начало, если оно указано. Это выражение обычно инициализирует один или несколько счётчиков, но синтаксис позволяет выражению быть любой сложности. Также используется для объявления переменных.
    2. -
  2. Выполняется условие. Если условие истинно, то выполняются выражения. Если оно ложно, цикл for прерывается. Если же условие полностью пропущено, то оно считается истинным.
    3. -
  3. Выполняются выражения. Чтобы выполнить несколько выражений, используются блок-выражение  { ... }  для группировки выражений.
    4. -
  4. Обновляется шаг, если он есть, а затем управление возвращается к шагу 2.
    5. -
- -

Пример

- -

В следующей функции есть цикл for, который считает количество выбранных жанров в списке прокрутки (элемент {{HTMLElement("select")}}, который позволяет выбрать несколько элементов). Цикл for объявляет переменную i и задаёт ей значение 0. Также он проверяет, что i меньше количества элементов в элементе <select>, выполняет оператор if и увеличивает i на один после каждого прохода цикла.

- -
<form name="selectForm">
-  <p>
-    <label for="musicTypes">Выберите некоторые жанры музыки, а затем нажмите на кнопку ниже:</label>
-    <select id="musicTypes" name="musicTypes" multiple="multiple">
-      <option selected="selected">R&B</option>
-      <option>Jazz</option>
-      <option>Blues</option>
-      <option>New Age</option>
-      <option>Classical</option>
-      <option>Opera</option>
-    </select>
-  </p>
-  <p><input id="btn" type="button" value="Как много выбрано?" /></p>
-</form>
-
-<script>
-function howMany(selectObject) {
-  var numberSelected = 0;
-  for (var i = 0; i < selectObject.options.length; i++) {
-    if (selectObject.options[i].selected) {
-      numberSelected++;
-    }
-  }
-  return numberSelected;
-}
-
-var btn = document.getElementById("btn");
-btn.addEventListener("click", function(){
-  alert('Выбрано элементов: ' + howMany(document.selectForm.musicTypes))
-});
-</script>
-
-
- -

Цикл do...while 

- -

Цикл do...while повторяется пока заданное условие истинно. Оператор do...while имеет вид:

- -
do
-  выражения
-while (условие);
-
- -

выражения выполняются пока условие истинно. Чтобы использовать несколько выражений, используйте блок-выражение  { ... }, чтобы сгруппировать их. Если условие истинно, выражения выполнятся снова. В конце каждого прохода условие проверяется. Если условие ложно, выполнение приостанавливается и управление передаётся выражению после do...while.

- -

Пример

- -

В следующем примере, цикл do выполнится минимум 1 раз и запускается снова, пока i меньше 5.

- -
do {
-  i += 1;
-  console.log(i);
-} while (i < 5);
- -

Цикл while

- -

Цикл while выполняет выражения пока условие истинно. Выглядит он так:

- -
while (условие)
-  выражения
-
- -

Если условие становится ложным, выражения в цикле перестают выполняться и управление переходит к выражению после цикла.

- -

Условие проверяется на истинность до того, как выполняются выражения в цикле. Если условие истинно, выполняются выражения, а затем условие проверяется снова. Если условие ложно, выполнение приостанавливается и управление переходит к выражению после while.

- -

Чтобы использовать несколько выражений, используйте блок выражение { ... }, чтобы сгруппировать их.

- -

Пример 1

- -

Следующий цикл while работает, пока n меньше трёх:

- -
var n = 0;
-var x = 0;
-while (n < 3) {
-  n++;
-  x += n;
-}
-
- -

С каждой итерацией, цикл увеличивает n и добавляет это значение к x. Поэтому, x и n получают следующие значения:

- - - -

После третьего прохода, условие n < 3 становится ложным, поэтому цикл прерывается.

- -

Пример 2

- -

Избегайте бесконечных циклов. Убедитесь, что условие цикла в итоге станет ложным; иначе, цикл никогда не прервётся. Выражения в следующем цикле while будут выполняться вечно, т.к. условие никогда не станет ложным:

- -
while (true) {
-  console.log("Hello, world");
-}
- -

Метка (label)

- -

Метка представляет собой оператор с индентификатором, который позволяет вам ссылаться на какое-то место в вашей программе. Например, вы можете использовать метку, чтобы обозначить цикл, а затем использовать операторы break или continue, чтобы указать, должна ли программа прерывать цикл или продолжать его выполнение.

- -

Синтаксис метки следующий:

- -
метка :
-   оператор
-
- -

Значение метки может быть любым корректным JavaScript индентификатором, не являющимся зарезервированным словом. Оператор, указанный вами после метки может быть любым выражением.

- -

Пример

- -

В этом примере, метка markLoop обозначает цикл while.

- -
markLoop:
-while (theMark == true) {
-   doSomething();
-}
- -

break

- -

Используйте оператор break, чтобы прерывать цикл, переключать управление или в сочетании с оператором метка.

- - - -

Синтаксис оператора может быть таким:

- -
    -
  1. break;
    2. -
  2. break Метка;
    3. -
- -

Первая форма синтаксиса прерывает цикл совсем или переключает управление; вторая прерывает специально обозначенное выражение.

- -

Пример 1

- -

Следующий пример проходит по элементам в массиве, пока не найдёт элемент, чьё значение - theValue:

- -
for (i = 0; i < a.length; i++) {
-  if (a[i] == theValue) {
-    break;
-  }
-}
- -

Пример 2: Прерывание метки

- -
var x = 0;
-var z = 0
-labelCancelLoops: while (true) {
-  console.log("Внешний цикл: " + x);
-  x += 1;
-  z = 1;
-  while (true) {
-    console.log("Внутренний цикл: " + z);
-    z += 1;
-    if (z === 10 && x === 10) {
-      break labelCancelLoops;
-    } else if (z === 10) {
-      break;
-    }
-  }
-}
-
- -

continue

- -

Оператор continue используется, чтобы шагнуть на шаг вперёд в циклах while, do-while, for или перейти к метке.

- - - -

Синтаксис continue может выглядеть так:

- -
    -
  1. continue;
    2. -
  2. continue Метка;
    3. -
- -

Пример 1

- -

Следующий пример показывает цикл while с оператором continue, который срабатывает, когда значение i равно 3. Таким образом, n получает значения 1, 3, 7 и 12.

- -
var i = 0;
-var n = 0;
-while (i < 5) {
-  i++;
-  if (i == 3) {
-    continue;
-  }
-  n += i;
-}
-
- -

Пример 2

- -

Выражение, отмеченное checkiandj содержит выражение отмеченное checkj. При встрече с continue, программа прерывает текущую итерацию checkj и начинает следующую итерацию. Каждый раз при встрече с continue, checkj переходит на следующую итерацию, пока условие возвращает false. Когда возвращается false, после вычисления остатка от деления checkiandj, checkiandj переходит на следующую итерацию, пока его условие возвращает false. Когда возвращается false, программа продолжает выполнение с выражения после checkiandj.

- -

Если у continue проставлена метка checkiandj, программа может продолжиться с начала метки checkiandj.

- -
checkiandj:
-  while (i < 4) {
-    console.log(i);
-    i += 1;
-    checkj:
-      while (j > 4) {
-        console.log(j);
-        j -= 1;
-        if ((j % 2) != 0) {
-          continue checkj;
-        }
-        console.log(j + " чётное.");
-      }
-      console.log("i = " + i);
-      console.log("j = " + j);
-  }
- -

for...in 

- -

Оператор for...in проходит по всем перечислимым свойствам объекта. JavaScript выполнит указанные выражения для каждого отдельного свойства. Цикл for...in выглядит так:

- -
for (variable in object) {
-  выражения
-}
-
- -

Пример

- -

Следующая функция берёт своим аргументом объект и его имя. Затем проходит по всем свойствам объекта и возвращает строку, которая содержит имена свойств и их значения.

- -
function dump_props(obj, obj_name) {
-  var result = "";
-  for (var i in obj) {
-    result += obj_name + "." + i + " = " + obj[i] + "<br>";
-  }
-  result += "<hr>";
-  return result;
-}
-
- -

Для объекта car со свойствами make и model, результатом будет:

- -
car.make = Ford
-car.model = Mustang
-
- -

Пример №2

- -

Также, по ключу можно выводить значение:

- -
let obj = {model: 'AUDI A8', year: '2019', color: 'brown'}
-
-for (key in obj) {
-  console.log(`${key} = ${obj[key]}`);
-}
-// model = AUDI A8
-// year = 2019
-// color = brown
- -

Массивы

- -

Хотя, очень заманчиво использовать for...in как способ пройтись по всем элементам {{jsxref("Array")}}, этот оператор возвращает имя свойств определённых пользователем помимо числовых индексов. Таким образом лучше использовать стандартный for для числовых индексов при взаимодействии с массивами, поскольку оператор for...in проходит по определённым пользователем свойствам в дополнение к элементам массива, если вы изменяете массив, например, добавляете свойства и методы.

- -

Пример

- -
let arr = ['AUDI A8', '2019', 'brown'];
-arr.cost = '$100.000';
-
-for (key in arr) {
-  console.log(`${key} = ${arr[key]}`);
-}
-
-// 0 = AUDI A8
-// 1 = 2019
-// 2 = brown
-// cost = $100.000
-
- -

for...of

- -

Оператор for...of создаёт цикл, проходящий по перечислимым объектам (включая {{jsxref("Array")}}, {{jsxref("Map")}}, {{jsxref("Set")}}, объект arguments и так далее), вызывая на каждой итерации функцию с выражениями, которые надо выполнить для получения значения каждого отдельного свойства.

- -
for (variable of object) {
-  выражения
-}
- -

Следующий пример показывает разницу между циклами for...of и for...in. Тогда как for...in проходит по именам свойств, for...of проходит по значениям свойств:

- -
let arr = [3, 5, 7];
-arr.foo = "hello";
-
-for (let i in arr) {
-   console.log(i); // выводит "0", "1", "2", "foo"
-}
-
-for (let i of arr) {
-   console.log(i); // выводит "3", "5", "7"
-}
-
- -

{{PreviousNext("Web/JavaScript/Guide/Control_flow_and_error_handling", "Web/JavaScript/Guide/Functions")}}

diff --git a/files/ru/web/javascript/introduction_to_object-oriented_javascript/index.html b/files/ru/web/javascript/introduction_to_object-oriented_javascript/index.html deleted file mode 100644 index d07cf043cc..0000000000 --- a/files/ru/web/javascript/introduction_to_object-oriented_javascript/index.html +++ /dev/null @@ -1,356 +0,0 @@ ---- -title: Вступление в Объектно-ориентированный JavaScript -slug: Web/JavaScript/Introduction_to_Object-Oriented_JavaScript -translation_of: Learn/JavaScript/Objects -translation_of_original: Web/JavaScript/Introduction_to_Object-Oriented_JavaScript ---- -

Объектно-ориентированный до основания, JavaScript предоставляет мощные и гибкие {{Glossary("OOP")}} возможности. Эта статья начинается с введения в объектно-ориентированное программирование, затем рассматривает модель объекта JavaScript и, наконец, демонстрирует концепции объектно-ориентированного программирования в JavaScript.

- -

Обзор JavaScript

- -

Если вы неуверенно владеете такими концепциями JavaScript, как переменные, типы, функции и области видимости, вы можете прочитать об этих темах в Повторное вступление в JavaScript. Вы также можете обратиться к JavaScript Guide.

- -

Объектно-ориентированное программирование

- -

Объектно-ориентированное программирование (ООП) — это парадигма программирования, которая использует {{glossary("абстракции")}}, чтобы создавать модели, основанные на объектах реального мира. ООП использует несколько техник из ранее признанных парадигм, включая {{glossary("модульность")}}, {{glossary("полиморфизм")}} и {{glossary("инкапсуляция")}}. На сегодняшний день многие популярные языки программирования (такие как Java, JavaScript, C#, C++, Python, PHP, Ruby и Objective-C) поддерживают ООП.

- -

ООП представляет программное обеспечение как совокупность взаимодействующих объектов, а не набор функций или просто список команд (как в традиционном представлении). В ООП, каждый объект может получать сообщения, обрабатывать данные, и отправлять сообщения другим объектам. Каждый объект может быть представлен как маленькая независимая машина с отдельной ролью или ответственностью.

- -

ООП способствует большей гибкости и поддерживаемости в программировании, и широко распространена в крупномасштабном программном инжиниринге. Так как ООП настоятельно подчеркивает модульность, объектно-ориентированный код проще в разработке и проще для понимания впоследствии. Объектно-ориентированный код способствует более точному анализу, кодированию и пониманию сложных ситуаций и процедур, чем методы программирования с меньшей модульностью.1

- -

Терминология

- -
-
{{Glossary("Пространство имён")}}
-
Контейнер, который позволяет разработчикам связать весь функционал под уникальным, специфичным для приложения именем.
-
{{Glossary("Класс")}}
-
Определяет характеристики объекта. Класс является описанием шаблона свойств и методов объекта.
-
{{Glossary("Объект")}}
-
Экземпляр класса.
-
{{Glossary("Свойство")}}
-
Характеристика объекта, например, цвет.
-
{{Glossary("Метод")}}
-
Возможности объекта, такие как ходьба. Это подпрограммы или функции, связанные с классом.
-
{{Glossary("Конструктор")}}
-
Метод, вызываемый в момент создания экземпляра объекта. Он, как правило, имеет то же имя, что и класс, содержащий его.
-
{{Glossary("Наследование")}}
-
Класс может наследовать характеристики от другого класса.
-
{{Glossary("Инкапсуляция")}}
-
Способ комплектации данных и методов, которые используют данные.
-
{{Glossary("Абстракция")}}
-
Совокупность комплексных наследований, методов и свойств объекта должны адекватно отражать модель реальности.
-
{{Glossary("Полиморфизм")}}
-
Поли означает "много", а морфизм "формы". Различные классы могут объявить один и тот же метод или свойство.
-
- -

Для более обширного описания объектно-ориентированного программирования, см {{interwiki("wikipedia", "Объектно-ориентированное_программирование")}} в Wikipedia.

- -

Прототипное программирование

- -

Прототипное программирование — это модель ООП которая не использует классы, а вместо этого сначала выполняет поведение класса и затем использует его повторно (эквивалент наследования в языках на базе классов), декорируя (или расширяя) существующие объекты прототипы. (Также называемое бесклассовое, прототипно-ориентированное, или экземплярно-ориентированное программирование.)

- -

Оригинальный (и наиболее каноничный) пример прототипно-ориентированного языка это {{interwiki("wikipedia", "Self (programming language)", "Self")}} разработанный Дэвидом Ангаром и Ренделлом Смитом. Однако бесклассовый стиль программирования стал набирать популярность позднее, и был принят для таких языков программирования, как JavaScript, Cecil, NewtonScript, Io, MOO, REBOL, Kevo, Squeak (при использовании фреймворка Viewer для манипуляции компонентами Morphic) и некоторых других.1

- -

Объектно-ориентированное программирование в JavaScript

- -

Пространство имён

- -

Пространство имён — это контейнер, который позволяет разработчикам собрать функциональность под уникальным именем приложения. Пространство имён в JavaScript — это объект, содержащий методы, свойства и другие объекты.

- -
-

Важно отметить, что на уровне языка в JavaScript нет разницы между пространством имён и любым другим объектом. Это отличает JS от множества других объектно-ориентированных языков и может стать причиной путаницы у начинающих JS программистов.

-
- -

Принцип работы пространства имён в JS прост: создать один глобальный объект и все переменные, методы и функции объявлять как свойства этого объекта. Также использование пространств имён снижает вероятность возникновения конфликтов имён в приложении так как каждый объект приложения является свойством глобального объекта.

- -

Давайте создадим глобальный объект MYAPP:

- -
// Глобальное пространство имён
-var MYAPP = MYAPP || {};
- -

Во фрагменте кода выше мы сначала проверяем определён ли объект MYAPP (в текущем файле или другом файле). Если да, то используем существующий глобальный объект MYAPP, иначе создаём пустой объект MYAPP, в котором мы инкапсулируем все методы, функции, переменные и объекты.

- -

Также мы можем создать подпространство имён (учтите, что сначала нужно объявить глобальный объект):

- -
// Подпространство имён
-MYAPP.event = {};
- -

Далее следует пример синтаксиса создания пространства имён и добавления переменных, функций и методов:

- -
// Создаём контейнер MYAPP.commonMethod для общих методов и свойств
-MYAPP.commonMethod = {
-  regExForName: "", // определяет регулярное выражение для валидации имени
-  regExForPhone: "", // определяет регулярное выражение для валидации телефона
-  validateName: function(name){
-    // Сделать что-то с name, вы можете получить доступ к переменной regExForName
-    // используя "this.regExForName"
-  },
-
-  validatePhoneNo: function(phoneNo){
-    // Сделать что-то с номером телефона
-  }
-}
-
-// Объект вместе с объявлением методов
-MYAPP.event = {
-    addListener: function(el, type, fn) {
-    // код
-    },
-    removeListener: function(el, type, fn) {
-    // код
-    },
-    getEvent: function(e) {
-    // код
-    }
-
-    // Можно добавить другие свойства и методы
-}
-
-// Синтаксис использования метода addListener:
-MYAPP.event.addListener("yourel", "type", callback);
- -

Стандартные встроенные объекты

- -

В JavaScript есть несколько объектов, встроенных в ядро, например {{jsxref("Math")}}, {{jsxref("Object")}}, {{jsxref("Array")}} и {{jsxref("String")}}. Пример ниже показывает как использовать объект Math, чтобы получить случайное число, используя его метод random().

- -
console.log(Math.random());
-
- -
Примечание: В данном примере и далее мы будем использовать глобальную функцию {{domxref("console.log()")}}. Если точнее, то функция console.log() не является частью JavaScript, но она поддерживается многими браузерами для облегчения отладки.
- -

Смотрите JavaScript Reference: Standard built-in objects, чтобы ознакомиться со списком всех встроенных объектов JavaScript.

- -

Каждый объект в JavaScript является экземпляром объекта Object, следовательно наследует все его свойства и методы.

- -

Объекты, создаваемые пользователем

- -

Класс

- -

JavaScript — это прототипно-ориентированный язык, и в нём нет оператора class, который имеет место в C++ или Java. Иногда это сбивает с толку программистов, привыкших к языкам с оператором class. Вместо этого JavaScript использует функции как конструкторы классов. Объявить класс так же просто как объявить функцию. В примере ниже мы объявляем новый класс Person с пустым конструктором:

- -
var Person = function () {};
-
- -

Объект (экземпляр класса)

- -

Для создания нового экзмепляра объекта obj мы используем оператор new obj, присваивая результат (который имеет тип obj) в переменную.

- -

В примере выше мы определили класс Person. В примере ниже мы создаём два его экземпляра (person1 и person2).

- -
var person1 = new Person();
-var person2 = new Person();
-
- -
Ознакомьтесь с {{jsxref("Object.create()")}}, новым, дополнительным методом инстанцирования, который создаёт неинициализированный экземпляр.
- -

Конструктор

- -

Конструктор вызывается в момент создания экземпляра класса (в тот самый момент, когда создается объект). Конструктор является методом класса. В JavaScript функция служит конструктором объекта, поэтому нет необходимости явно определять метод конструктор. Любое действие определенное в конструкторе будет выполненно в момент создания экземпляра класса.

- -

Конструктор используется для задания свойств объекта или для вызова методов, которые подготовят объект к использованию. Добавление методов и их описаний производится с использованием другого синтаксиса, описанного далее в этой статье.

- -

В примере ниже, конструктор класса Person выводит в консоль сообщение в момент создания нового экземпляра Person.

- -
var Person = function () {
-  console.log('instance created');
-};
-
-var person1 = new Person();
-var person2 = new Person();
-
- -

Свойство (аттрибут объекта)

- -

Свойства — это переменные, содержащиеся в классе; каждый экземпляр объекта имеет эти свойства. Свойства устанавливаются в конструкторе (функции) класса, таким образом они создаются для каждого экземпляра.

- -

Ключевое слово this, которое ссылается на текущий объект, позволяет вам работать со свойствами класса. Доступ (чтение и запись) к свойствам снаружи класса осуществляется синтаксисом InstanceName.Property, так же как в C++, Java и некоторых других языках. (Внутри класса для получения и изменения значений свойств используется синтаксис this.Property)

- -

В примере ниже, мы определяем свойство firstName для класса Person при создании экземпляра:

- -
var Person = function (firstName) {
-  this.firstName = firstName;
-  console.log('Person instantiated');
-};
-
-var person1 = new Person('Alice');
-var person2 = new Person('Bob');
-
-// Выводит свойство firstName в консоль
-console.log('person1 is ' + person1.firstName); // выведет "person1 is Alice"
-console.log('person2 is ' + person2.firstName); // выведет "person2 is Bob"
-
- -

Методы

- -

Методы — это функции (и определяются как функции), но с другой стороны следуют той же логике, что и свойства. Вызов метода похож на доступ к свойству, но вы добавляете () на конце имени метода, возможно, с аргументами. Чтобы объявить метод, присвойте функцию в именованное свойство свойства prototype класса. Потом вы сможете вызвать метод объекта под тем именем, которое вы присвоили функции.

- -

В примере ниже мы определяем и используем метод sayHello() для класса Person.

- -
var Person = function (firstName) {
-  this.firstName = firstName;
-};
-
-Person.prototype.sayHello = function() {
-  console.log("Hello, I'm " + this.firstName);
-};
-
-var person1 = new Person("Alice");
-var person2 = new Person("Bob");
-
-// вызываем метод sayHello() класса Person
-person1.sayHello(); // выведет "Hello, I'm Alice"
-person2.sayHello(); // выведет "Hello, I'm Bob"
-
- -

В JavaScript методы это — обычные объекты функций, связанные с объектом как свойства: это означает, что вы можете вызывать методы "вне контекста". Рассмотрим следующий пример:

- -
var Person = function (firstName) {
-  this.firstName = firstName;
-};
-
-Person.prototype.sayHello = function() {
-  console.log("Hello, I'm " + this.firstName);
-};
-
-var person1 = new Person("Alice");
-var person2 = new Person("Bob");
-var helloFunction = person1.sayHello;
-
-// выведет "Hello, I'm Alice"
-person1.sayHello();
-
-// выведет "Hello, I'm Bob"
-person2.sayHello();
-
-// выведет "Hello, I'm undefined" (or fails
-// with a TypeError in strict mode)
-helloFunction();
-
-// выведет true
-console.log(helloFunction === person1.sayHello);
-
-// выведет true
-console.log(helloFunction === Person.prototype.sayHello);
-
-// выведет "Hello, I'm Alice"
-helloFunction.call(person1);
- -

Как показывает пример, все ссылки, которые мы имеем на функцию sayHello — person1, Person.prototype, переменная helloFunction и т.д. — ссылаются на одну и ту же функцию. Значение this в момент вызова функции зависит от того, как мы её вызываем. Наиболее часто мы обращаемся к this в выражениях, где мы получаем функцию из свойства объекта — person1.sayHello() — this устанавливается на объект, из которого мы получили функцию (person1), вот почему person1.sayHello() использует имя "Alice", а person2.sayHello() использует имя "Bob". Но если вызов будет совершён иначе, то this будет иным: вызов this из переменной — helloFunction() — установит this на глобальный объект (window в браузерах). Так как этот объект (вероятно) не имеет свойства firstName, функция выведет "Hello, I'm undefined" (так произойдёт в нестрогом режиме; в strict mode всё будет иначе (ошибка), не будем сейчас вдаваться в подробности, чтобы избежать путаницы). Или мы можем указать this явно с помощью Function#call (или Function#apply) как показано в конце примера.

- -
Примечание: Смотрите подробнее о this в  Function#call и Function#apply
- -

Наследование

- -

Наследование — это способ создать класс как специализированную версию одного или нескольких классов (JavaScript поддерживает только одиночное наследование). Специализированный класс, как правило, называют потомком, а другой класс родителем. В JavaScript наследование осуществляется присвоением экземпляра класса родителя классу потомку. В современных браузерах вы можете реализовать наследование с помощью Object.create.

- -
Примечание: JavaScript не обнаружит prototype.constructor класса потомка (смотрите Object.prototype) так что мы должны указать его вручную. Смотрите вопрос "Why is it necessary to set the prototype constructor?" на Stackoverflow.
- -

В примере ниже мы определяем класс Student как потомка класса Person. Потом мы переопределяем метод sayHello() и добавляем метод addGoodBye().

- -
// Определяем конструктор Person
-var Person = function(firstName) {
-  this.firstName = firstName;
-};
-
-// Добавляем пару методов в Person.prototype
-Person.prototype.walk = function(){
-  console.log("I am walking!");
-};
-
-Person.prototype.sayHello = function(){
-  console.log("Hello, I'm " + this.firstName);
-};
-
-// Определяем конструктор Student
-function Student(firstName, subject) {
-  // Вызываем конструктор родителя, убедившись (используя Function#call)
-  // что "this" в момент вызова установлен корректно
-  Person.call(this, firstName);
-
-  // Инициируем свойства класса Student
-  this.subject = subject;
-};
-
-// Создаём объект Student.prototype, который наследуется от Person.prototype.
-// Примечание: Рспространённая ошибка здесь, это использование "new Person()", чтобы создать
-// Student.prototype. Это неверно по нескольким причинам, не в последнюю очередь
-// потому, что нам нечего передать в Person в качестве аргумента "firstName"
-// Правильное место для вызова Person показано выше, где мы вызываем
-// его в конструкторе Student.
-Student.prototype = Object.create(Person.prototype); // Смотрите примечание выше
-
-// Устанавливаем свойство "constructor" для ссылки на класс Student
-Student.prototype.constructor = Student;
-
-// Заменяем метод "sayHello"
-Student.prototype.sayHello = function(){
-  console.log("Hello, I'm " + this.firstName + ". I'm studying "
-              + this.subject + ".");
-};
-
-// Добавляем метод "sayGoodBye"
-Student.prototype.sayGoodBye = function(){
-  console.log("Goodbye!");
-};
-
-// Пример использования:
-var student1 = new Student("Janet", "Applied Physics");
-student1.sayHello();   // "Hello, I'm Janet. I'm studying Applied Physics."
-student1.walk();       // "I am walking!"
-student1.sayGoodBye(); // "Goodbye!"
-
-// Проверяем, что instanceof работает корректно
-console.log(student1 instanceof Person);  // true
-console.log(student1 instanceof Student); // true
-
- -

Относительно строки Student.prototype = Object.create(Person.prototype);: В старых движках JavaScript, в которых нет  Object.create можно использовать полифилл (ещё известный как "shim") или функцию которая достигает тех же результатов, такую как:

- -
function createObject(proto) {
-    function ctor() { }
-    ctor.prototype = proto;
-    return new ctor();
-}
-
-// Пример использования:
-Student.prototype = createObject(Person.prototype);
-
- -
Примечание: Смотрите Object.create для более подробной информации, и shim для реализации на старых движках.
- -

Инкапсуляция

- -

В примере выше классу Student нет необходимости знать о реализации метода walk() класса Person, но он может его использовать; Класс Student не должен явно определять этот метод, пока мы не хотим его изменить. Это называется инкапсуляция, благодаря чему каждый класс собирает данные и методы в одном блоке.

- -

Сокрытие информации распространённая особенность, часто реализуемая в других языках программирования как приватные и защищённые методы/свойства. Однако в JavaScript можно лишь имитировать нечто подобное, это не является необходимым требованием объектно-ориентированного программирования.2

- -

Абстракция

- -

Абстракция это механизм который позволяет смоделировать текущий фрагмент рабочей проблемы, с помощью наследования (специализации) или композиции. JavaScript достигает специализации наследованием, а композиции возможностью экземплярам класса быть значениями атрибутов других объектов.

- -

В JavaScript класс Function наследуется от класса Object (это демонстрирует специализацию), а свойство Function.prototype это экземпляр класса Object (это демонстрирует композицию).

- -
var foo = function () {};
-
-// выведет "foo is a Function: true"
-console.log('foo is a Function: ' + (foo instanceof Function));
-
-// выведет "foo.prototype is an Object: true"
-console.log('foo.prototype is an Object: ' + (foo.prototype instanceof Object));
- -

Полиморфизм

- -

Так как все методы и свойства определяются внутри свойства prototype, различные классы могут определять методы с одинаковыми именами; методы находятся в области видимости класса в котором они определены, пока два класса не имеют связи родитель-потомок (например, один наследуется от другого в цепочке наследований).

- -

Примечания

- -

Это не все способы которыми можно реализовать объектно-ориентированное программирование в JavaScript, который очень гибок в этом отношении. Также способы рассмотренные здесь не отражают всех возможностей JavaScript и не подражают реализации теории объектов в других языках.

- -

Существуют другие способы, которые реализуют ещё более продвинутое объектно-ориентированное программирование на JavaScript, но они выходят за рамки этой вводной статьи.

- -

Ссылки

- -
    -
  1. Wikipedia. "Object-oriented programming"
    2. -
  2. Wikipedia. "Encapsulation (object-oriented programming)"
    3. -
diff --git "a/files/ru/web/javascript/javascript_\321\210\320\265\320\273\320\273\321\213/index.html" "b/files/ru/web/javascript/javascript_\321\210\320\265\320\273\320\273\321\213/index.html" deleted file mode 100644 index b6e3421b96..0000000000 --- "a/files/ru/web/javascript/javascript_\321\210\320\265\320\273\320\273\321\213/index.html" +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: JavaScript оболочки -slug: Web/JavaScript/JavaScript_шеллы -translation_of: Web/JavaScript/Shells ---- -
{{JsSidebar}}
- -

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

- -

Автономные JavaScript оболочки

- -

Следующие JavaScript шеллы являются автономными средами, как Perl или Python.

- - - -

Список JavaScript оболочек

- -

Следующие JavaScript оболочки работают с Mozilla.

- - diff --git a/files/ru/web/javascript/reference/about/index.html b/files/ru/web/javascript/reference/about/index.html new file mode 100644 index 0000000000..bbb30f131d --- /dev/null +++ b/files/ru/web/javascript/reference/about/index.html @@ -0,0 +1,50 @@ +--- +title: Об этой справке +slug: Web/JavaScript/Reference/Об +translation_of: Web/JavaScript/Reference/About +--- +
{{JsSidebar}}
+ +

The JavaScript reference serves as a repository of facts about the JavaScript language. The entire language is described here in detail. As you write JavaScript code, you'll refer to these pages often (thus the title "JavaScript reference"). If you're learning JavaScript, or need help understanding some of its capabilities or features, check out the JavaScript guide.

+ +

The JavaScript language is intended to be used within some larger environment, be it a browser, server-side scripts, or similar. For the most part, this reference attempts to be environment-agnostic and does not target a web browser environment.

+ +

Where to find JavaScript information

+ +

JavaScript documentation of core language features (pure ECMAScript, for the most part) includes the following:

+ + + +

If you are new to JavaScript, start with the guide. Once you have a firm grasp of the fundamentals, you can use the reference to get more details on individual objects and language constructs.

+ +

Structure of the reference

+ +

In the JavaScript reference you can find the following chapters:

+ +
+
Standard built-in objects
+
This chapter documents all the JavaScript standard built-in objects, along with their methods and properties.
+
Statements and declarations
+
JavaScript applications consist of statements with an appropriate syntax. A single statement may span multiple lines. Multiple statements may occur on a single line if each statement is separated by a semicolon. This isn't a keyword, but a group of keywords.
+
Expressions and operators
+
This chapter documents all the JavaScript language operators, expressions and keywords.
+
Functions
+
Chapter about JavaScript functions.
+
Classes
+
Chapter about JavaScript classes introduced in ECMAScript 6.
+
Errors
+
Chapter about specific errors, exceptions and warnings thrown by JavaScript.
+
New in JavaScript
+
Chapter about JavaScript version history.
+
+ +

More reference pages

+ + diff --git a/files/ru/web/javascript/reference/classes/class_fields/index.html b/files/ru/web/javascript/reference/classes/class_fields/index.html deleted file mode 100644 index ade4b8151f..0000000000 --- a/files/ru/web/javascript/reference/classes/class_fields/index.html +++ /dev/null @@ -1,350 +0,0 @@ ---- -title: Поля классов -slug: Web/JavaScript/Reference/Classes/Class_fields -tags: - - JavaScript - - Классы -translation_of: Web/JavaScript/Reference/Classes/Public_class_fields ---- -
{{JsSidebar("Classes")}}
- -
Объявление публичных и приватных полей является экспериментальной разработкой, предложенной в коммитете стандартов JavaScript TC39. Поддержка браузерами ограничена, но данное нововведение можно использовать посредством транспиляторов (например, Babel). Смотрите информацию о совместимости ниже.
- -

Публичные поля

- -

И статические, и публичные поля являются изменяемыми, перечисляемыми, настраиваемыми свойствами. Таким образом, в отличие от приватных полей, они участвуют в прототипном наследовании.

- -

Публичные статические поля

- -

Публичные статические поля полезны тогда, когда необходимо существование одного единственного поля для всего класса, а не для каждого созданного экземпляра по отдельности. Это полезно для кеша, конфигураций или любых прочих данных, которые одинаковы для всех экземпляров.

- -

Публичные статические поля объявляются при помощи ключевого слова static. Они добавляются в конструктор класса во время его создания с помощью Object.defineProperty. Доступ также осуществляется через конструктор класса.

- -
class ClassWithStaticField {
-  static staticField = 'static field';
-}
-
-console.log(ClassWithStaticField.staticField);
-// Ожидаемый вывод: "static field"
-
- -

Поля без инициализации имеют значение undefined.

- -
class ClassWithStaticField {
-  static staticField;
-}
-
-console.assert(ClassWithStaticField.hasOwnProperty('staticField'));
-console.log(ClassWithStaticField.staticField);
-// Ожидаемый вывод: "undefined"
- -

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

- -
class ClassWithStaticField {
-  static baseStaticField = 'base field';
-}
-
-class SubClassWithStaticField extends ClassWithStaticField {
-  static subStaticField = 'sub class field';
-}
-
-console.log(SubClassWithStaticField.subStaticField);
-// Ожидаемый вывод: "sub class field"
-
-console.log(SubClassWithStaticField.baseStaticField);
-// Ожидаемый вывод: "base field"
- -

При определении полей this ссылается на конструктор класса. Также можно обратиться к нему по имени и использовать super для получения конструктора базового класса, если он существует.

- -
class ClassWithStaticField {
-  static baseStaticField = 'base static field';
-  static anotherBaseStaticField = this.baseStaticField;
-
-  static baseStaticMethod() { return 'base static method output'; }
-}
-
-class SubClassWithStaticField extends ClassWithStaticField {
-  static subStaticField = super.baseStaticMethod();
-}
-
-console.log(ClassWithStaticField.anotherBaseStaticField);
-// Ожидаемый вывод: "base static field"
-
-console.log(SubClassWithStaticField.subStaticField);
-// Ожидаемый вывод: "base static method output"
-
- -

Публичные поля экземпляра

- -

Такие публичные поля имеются у каждого экземпляра данного класса. Объявляя публичные поля, мы можем гарантировать, что поле всегда актуально, а объявление класса является более самодокументированным.

- -

Публичные поля экземпляра добавляются через Object.defineProperty либо перед тем, как будет исполнено тело конструктора в базовом классе, либо после того, как завершится super() в классе наследнике.

- -
class ClassWithInstanceField {
-  instanceField = 'instance field';
-}
-
-const instance = new ClassWithInstanceField();
-console.log(instance.instanceField);
-// Ожидаемый вывод: "instance field"
- -

Поля без инициализации имеют значение undefined.

- -
class ClassWithInstanceField {
-  instanceField;
-}
-
-const instance = new ClassWithInstanceField();
-console.assert(instance.hasOwnProperty('instanceField'));
-console.log(instance.instanceField);
-// Ожидаемый вывод: "undefined"
- -

Как и свойства, названия полей могут вычисляться.

- -
const PREFIX = 'prefix';
-
-class ClassWithComputedFieldName {
-    [`${PREFIX}Field`] = 'prefixed field';
-}
-
-const instance = new ClassWithComputedFieldName();
-console.log(instance.prefixField);
-// Ожидаемый вывод: "prefixed field"
- -

При определении полей this ссылается на создающийся экземпляр класса. Как и в публичных методах экземпляра, получить доступ к прототипу базового класса можно с помощью super.

- -
class ClassWithInstanceField {
-  baseInstanceField = 'base field';
-  anotherBaseInstanceField = this.baseInstanceField;
-  baseInstanceMethod() { return 'base method output'; }
-}
-
-class SubClassWithInstanceField extends ClassWithInstanceField {
-  subInstanceField = super.baseInstanceMethod();
-}
-
-const base = new ClassWithInstanceField();
-const sub = new SubClassWithInstanceField();
-
-console.log(base.anotherBaseInstanceField);
-// Ожидаемый вывод: "base field"
-
-console.log(sub.subInstanceField);
-// Ожидаемый вывод: "base method output"
- -

Публичные методы

- -

Публичные статические методы

- -

Ключевое слово static объявляет статический метод класса. Статические методы не вызываются из экземпляра, вместо этого они вызывается из самого класса. Чаще всего это какие-либо служебные функции, такие как функции создания или копирования объектов.

- -

{{EmbedInteractiveExample("pages/js/classes-static.html")}}

- - - -

Статические методы добавляются в конструктор класса с помощью Object.defineProperty во время его создания. Эти методы - изменяемые, неперечисляемые и настраеваемые свойства объекта.

- -

Публичные методы экземпляра

- -

Как и следует из названия, публичные методы экземпляра это методы, доступные для вызова из экземпляров.

- -
class ClassWithPublicInstanceMethod {
-  publicMethod() {
-    return 'hello world';
-  }
-}
-
-const instance = new ClassWithPublicInstanceMethod();
-console.log(instance.publicMethod());
-// Ожидаемый вывод: "hello worl​d"
- -

Публичные методы добавляются в прототип класса во время его создания с помощью Object.defineProperty. Они изменяемы, неперечисляемы и настраиваемы.

- -

Вы можете использовать генераторы, асинхронные функции и асинхронные генераторы.

- -
class ClassWithFancyMethods {
-  *generatorMethod() { }
-  async asyncMethod() { }
-  async *asyncGeneratorMethod() { }
-}
- -

Внутри методов экземпляра, this ссылается на сам экземпляр.
- В классах наследниках, super дает доступ к прототипу базового класса, позволяя вызывать его методы.

- -
class BaseClass {
-  msg = 'hello world';
-  basePublicMethod() {
-    return this.msg;
-  }
-}
-
-class SubClass extends BaseClass {
-  subPublicMethod() {
-    return super.basePublicMethod();
-  }
-}
-
-const instance = new SubClass();
-console.log(instance.subPublicMethod());
-// Ожидаемый вывод: "hello worl​d"
-
- -

Геттеры и сеттеры это специальные методы, которые привязаны к свойствам класса и которые вызываются, когда к свойсту обращаются или записывают. Используйте get и set для объявления публичных геттеров и сеттеров экземпляра.

- -
class ClassWithGetSet {
-  #msg = 'hello world';
-  get msg() {
-    return this.#msg;
-  }
-  set msg(x) {
-    this.#msg = `hello ${x}`;
-  }
-}
-
-const instance = new ClassWithGetSet();
-console.log(instance.msg);
-// Ожидаемый вывод: "hello worl​d"
-
-instance.msg = 'cake';
-console.log(instance.msg);
-// Ожидаемый вывод: "hello cake"
-
- -

Приватные поля

- -

Приватные статические поля

- -

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

- -

Также сохраняется ограничение на вызов статических полей только внутри статических методов.

- -
class ClassWithPrivateStaticField {
-  static #PRIVATE_STATIC_FIELD;
-
-  static publicStaticMethod() {
-    ClassWithPrivateStaticField.#PRIVATE_STATIC_FIELD = 42;
-    return ClassWithPrivateStaticField.#PRIVATE_STATIC_FIELD;
-  }
-}
-
-assert(ClassWithPrivateStaticField.publicStaticMethod() === 42);
- -

Приватные статические поля добавляются в конструктор на этапе оценки класса.

- -

Существует ограничение происхождения приватных статических полей. Только класс, который объявляет приватное статическое поле, может обращаться к нему. Это может привести к неожиданному поведению при использовании this.

- -
class BaseClassWithPrivateStaticField {
-  static #PRIVATE_STATIC_FIELD;
-
-  static basePublicStaticMethod() {
-    this.#PRIVATE_STATIC_FIELD = 42;
-    return this.#PRIVATE_STATIC_FIELD;
-  }
-}
-
-class SubClass extends BaseClassWithPrivateStaticField { }
-
-assertThrows(() => SubClass.basePublicStaticMethod(), TypeError);
-
- -

Приватные поля экземпляра объекта

- -

Приватные поля объекта объявляются как # names ( произносятся как "hash names"), которые являются идентификаторами с префиксом #.  # является частью самого имени и также используется для объявления и доступа.

- -

Инкапсуляция обеспечивается языком. Ссылка на # names вне области видимости является синтаксической ошибкой.

- -
class ClassWithPrivateField {
-  #privateField;
-
-  constructor() {
-    this.#privateField = 42;
-    this.#randomField = 666; # Syntax error
-  }
-}
-
-const instance = new ClassWithPrivateField();
-instance.#privateField === 42; // Syntax error
-
- -

Приватные методы

- -

Приватные статические методы

- -

Как и публичные методы, приватные статические методы вызываются в классе, а не в экземплярах класса. Как и приватные статические поля, они доступны только из объявления класса.

- -

Приватные статические методы могут быть генераторами, асинхронными функциями и асинхронными генераторами.

- -
class ClassWithPrivateStaticMethod {
-    static #privateStaticMethod() {
-        return 42;
-    }
-
-    static publicStaticMethod() {
-        return ClassWithPrivateStaticMethod.#privateStaticMethod();
-    }
-}
-
-assert(ClassWithPrivateStaticField.publicStaticMethod() === 42);
-
- -

Приватные методы экземпляра объекта

- -

Приватные методы экземпляра объекта являются методами, доступными в экземплярах класса чей доступ ограничен так же, как и приватные поля экземпляра объекта.

- -
class ClassWithPrivateMethod {
-  #privateMethod() {
-    return 'hello world';
-  }
-
-  getPrivateMessage() {
-      return #privateMethod();
-  }
-}
-
-const instance = new ClassWithPrivateMethod();
-console.log(instance.getPrivateMessage());
-// expected output: "hello worl​d"
- -

Приватные методы экземпляра объекта могут быть генераторами, асинхронными функциями и асинхронными генераторами. Также возможны приватные геттеры и сеттеры:

- -
class ClassWithPrivateAccessor {
-  #message;
-
-  get #decoratedMessage() {
-    return `✨${this.#message}✨`;
-  }
-  set #decoratedMessage(msg) {
-    this.#message = msg;
-  }
-
-  constructor() {
-    this.#decoratedMessage = 'hello world';
-    console.log(this.#decoratedMessage);
-  }
-}
-
-new ClassWithPrivateAccessor();
-// expected output: "✨hello worl​d✨"
-
- -

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

- -

Публичные поля класса

- - - -

{{Compat("javascript.classes.public_class_fields")}}

- -

Приватные поля класса

- - - -

{{Compat("javascript.classes.private_class_fields")}}

- -

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

- - diff --git a/files/ru/web/javascript/reference/classes/private_class_fields/index.html b/files/ru/web/javascript/reference/classes/private_class_fields/index.html new file mode 100644 index 0000000000..09fe2505e2 --- /dev/null +++ b/files/ru/web/javascript/reference/classes/private_class_fields/index.html @@ -0,0 +1,205 @@ +--- +title: Приватные поля класса +slug: Web/JavaScript/Reference/Classes/Приватные_поля_класса +translation_of: Web/JavaScript/Reference/Classes/Private_class_fields +--- +
{{JsSidebar("Classes")}}
+ +

Свойства класса по умолчанию являются общедоступными и могут быть рассмотрены или изменены вне класса. Тем не менее, есть экспериментальное предложение, позволяющее определить приватные поля класса, используя префикс хэша #.

+ +

Синтаксис

+ +
class ClassWithPrivateField {
+  #privateField
+}
+
+class ClassWithPrivateMethod {
+  #privateMethod() {
+    return 'hello world'
+ }
+}
+
+class ClassWithPrivateStaticField {
+  static #PRIVATE_STATIC_FIELD
+}
+
+ +

Примеры

+ +

Приватные статические поля

+ +

Приватные поля доступны в конструкторе класса изнутри самой декларации класса.

+ +

Ограничение статических переменных, вызываемых только статическими методами, все еще сохраняется.

+ +
class ClassWithPrivateStaticField {
+  static #PRIVATE_STATIC_FIELD
+
+  static publicStaticMethod() {
+    ClassWithPrivateStaticField.#PRIVATE_STATIC_FIELD = 42
+    return ClassWithPrivateStaticField.#PRIVATE_STATIC_FIELD
+  }
+}
+
+console.assert(ClassWithPrivateStaticField.publicStaticMethod() === 42)
+ +

Приватные статические поля добавляются в конструктор класса во время обработки класса.

+ +

Существует ограничение по происхождению частных статических полей. Только класс, который определяет приватное статическое поле, может получить доступ к этому полю.

+ +

Это может привести к неожиданному поведению при использовании this.

+ +
class BaseClassWithPrivateStaticField {
+  static #PRIVATE_STATIC_FIELD
+
+  static basePublicStaticMethod() {
+    this.#PRIVATE_STATIC_FIELD = 42
+    return this.#PRIVATE_STATIC_FIELD
+  }
+}
+
+class SubClass extends BaseClassWithPrivateStaticField { }
+
+let error = null
+
+try {
+  SubClass.basePublicStaticMethod()
+} catch(e) { error = e}
+
+console.assert(error instanceof TypeError)
+
+ +

Приватные поля экземпляров

+ +

Приватные поля экзмепляров объявляются #имя (произносится как "хэш нэймс"), которые идентифицируются префиксом #. # является частью имени, а также используется для объявления и доступа.

+ +

Инкапсуляция обеспечивается языком. Обращение к # именам вне области видимости является синтаксической ошибкой.

+ +
class ClassWithPrivateField {
+  #privateField
+
+  constructor() {
+    this.#privateField = 42
+    this.#randomField = 666 // Syntax error
+  }
+}
+
+const instance = new ClassWithPrivateField()
+instance.#privateField === 42 // Syntax error
+
+ +

Приватные методы

+ +

Приватные статические методы

+ +

Приватные статические методы

+ +

Как и их публичный эквивалент, приватные статические методы вызываются на самом классе, а не на экземплярах класса. Как и приватные статические поля, они доступны только изнутри объявления класса.

+ +

Приватные статические методы могут быть генераторами, асинхронными функциями и асинхронными функциями-генераторами.

+ +
class ClassWithPrivateStaticMethod {
+    static #privateStaticMethod() {
+        return 42
+    }
+
+    static publicStaticMethod1() {
+        return ClassWithPrivateStaticMethod.#privateStaticMethod();
+    }
+
+    static publicStaticMethod2() {
+        return this.#privateStaticMethod();
+    }
+}
+
+console.assert(ClassWithPrivateStaticMethod.publicStaticMethod1() === 42);
+console.assert(ClassWithPrivateStaticMethod.publicStaticMethod2() === 42);
+
+ +

Это может привести к неожиданному поведению при его использовании this. В следующем примере this относится к классу Derived (а не к классу Base), когда мы пытаемся вызвать Derived.publicStaticMethod2(), и, таким образом, имеет такое же "ограничение по происхождению", как упоминалось выше:

+ +
class Base {
+    static #privateStaticMethod() {
+        return 42;
+    }
+    static publicStaticMethod1() {
+        return Base.#privateStaticMethod();
+    }
+    static publicStaticMethod2() {
+        return this.#privateStaticMethod();
+    }
+}
+
+class Derived extends Base {}
+
+console.log(Derived.publicStaticMethod1()); // 42
+console.log(Derived.publicStaticMethod2()); // TypeError
+
+ +

Приватные методы экземпляров(instance)

+ +

Приватные методы экземпляров это методы, доступные у экземпляров класса, доступ к которым запрещен также, как у приватных полей класса.

+ +
class ClassWithPrivateMethod {
+  #privateMethod() {
+    return 'hello world'
+  }
+
+  getPrivateMessage() {
+      return this.#privateMethod()
+  }
+}
+
+const instance = new ClassWithPrivateMethod()
+console.log(instance.getPrivateMessage())
+// expected output: "hello worl​d"
+ +

Приватные методы экземпляров могут быть генератором, async, или функциями async генератора. Приватные геттеры и сеттеры также возможны:

+ +
class ClassWithPrivateAccessor {
+  #message
+
+  get #decoratedMessage() {
+    return `✨${this.#message}✨`
+  }
+  set #decoratedMessage(msg) {
+    this.#message = msg
+  }
+
+  constructor() {
+    this.#decoratedMessage = 'hello world'
+    console.log(this.#decoratedMessage)
+  }
+}
+
+new ClassWithPrivateAccessor();
+// expected output: "✨hello worl​d✨"
+
+ +

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

+ + + + + + + + + + + + +
Specification
{{SpecName('Public and private instance fields', '#prod-FieldDefinition', 'FieldDefinition')}}
+ +

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

+ + + +

{{Compat("javascript.classes.private_class_fields")}}

+ +

См. также

+ + diff --git a/files/ru/web/javascript/reference/classes/public_class_fields/index.html b/files/ru/web/javascript/reference/classes/public_class_fields/index.html new file mode 100644 index 0000000000..ade4b8151f --- /dev/null +++ b/files/ru/web/javascript/reference/classes/public_class_fields/index.html @@ -0,0 +1,350 @@ +--- +title: Поля классов +slug: Web/JavaScript/Reference/Classes/Class_fields +tags: + - JavaScript + - Классы +translation_of: Web/JavaScript/Reference/Classes/Public_class_fields +--- +
{{JsSidebar("Classes")}}
+ +
Объявление публичных и приватных полей является экспериментальной разработкой, предложенной в коммитете стандартов JavaScript TC39. Поддержка браузерами ограничена, но данное нововведение можно использовать посредством транспиляторов (например, Babel). Смотрите информацию о совместимости ниже.
+ +

Публичные поля

+ +

И статические, и публичные поля являются изменяемыми, перечисляемыми, настраиваемыми свойствами. Таким образом, в отличие от приватных полей, они участвуют в прототипном наследовании.

+ +

Публичные статические поля

+ +

Публичные статические поля полезны тогда, когда необходимо существование одного единственного поля для всего класса, а не для каждого созданного экземпляра по отдельности. Это полезно для кеша, конфигураций или любых прочих данных, которые одинаковы для всех экземпляров.

+ +

Публичные статические поля объявляются при помощи ключевого слова static. Они добавляются в конструктор класса во время его создания с помощью Object.defineProperty. Доступ также осуществляется через конструктор класса.

+ +
class ClassWithStaticField {
+  static staticField = 'static field';
+}
+
+console.log(ClassWithStaticField.staticField);
+// Ожидаемый вывод: "static field"
+
+ +

Поля без инициализации имеют значение undefined.

+ +
class ClassWithStaticField {
+  static staticField;
+}
+
+console.assert(ClassWithStaticField.hasOwnProperty('staticField'));
+console.log(ClassWithStaticField.staticField);
+// Ожидаемый вывод: "undefined"
+ +

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

+ +
class ClassWithStaticField {
+  static baseStaticField = 'base field';
+}
+
+class SubClassWithStaticField extends ClassWithStaticField {
+  static subStaticField = 'sub class field';
+}
+
+console.log(SubClassWithStaticField.subStaticField);
+// Ожидаемый вывод: "sub class field"
+
+console.log(SubClassWithStaticField.baseStaticField);
+// Ожидаемый вывод: "base field"
+ +

При определении полей this ссылается на конструктор класса. Также можно обратиться к нему по имени и использовать super для получения конструктора базового класса, если он существует.

+ +
class ClassWithStaticField {
+  static baseStaticField = 'base static field';
+  static anotherBaseStaticField = this.baseStaticField;
+
+  static baseStaticMethod() { return 'base static method output'; }
+}
+
+class SubClassWithStaticField extends ClassWithStaticField {
+  static subStaticField = super.baseStaticMethod();
+}
+
+console.log(ClassWithStaticField.anotherBaseStaticField);
+// Ожидаемый вывод: "base static field"
+
+console.log(SubClassWithStaticField.subStaticField);
+// Ожидаемый вывод: "base static method output"
+
+ +

Публичные поля экземпляра

+ +

Такие публичные поля имеются у каждого экземпляра данного класса. Объявляя публичные поля, мы можем гарантировать, что поле всегда актуально, а объявление класса является более самодокументированным.

+ +

Публичные поля экземпляра добавляются через Object.defineProperty либо перед тем, как будет исполнено тело конструктора в базовом классе, либо после того, как завершится super() в классе наследнике.

+ +
class ClassWithInstanceField {
+  instanceField = 'instance field';
+}
+
+const instance = new ClassWithInstanceField();
+console.log(instance.instanceField);
+// Ожидаемый вывод: "instance field"
+ +

Поля без инициализации имеют значение undefined.

+ +
class ClassWithInstanceField {
+  instanceField;
+}
+
+const instance = new ClassWithInstanceField();
+console.assert(instance.hasOwnProperty('instanceField'));
+console.log(instance.instanceField);
+// Ожидаемый вывод: "undefined"
+ +

Как и свойства, названия полей могут вычисляться.

+ +
const PREFIX = 'prefix';
+
+class ClassWithComputedFieldName {
+    [`${PREFIX}Field`] = 'prefixed field';
+}
+
+const instance = new ClassWithComputedFieldName();
+console.log(instance.prefixField);
+// Ожидаемый вывод: "prefixed field"
+ +

При определении полей this ссылается на создающийся экземпляр класса. Как и в публичных методах экземпляра, получить доступ к прототипу базового класса можно с помощью super.

+ +
class ClassWithInstanceField {
+  baseInstanceField = 'base field';
+  anotherBaseInstanceField = this.baseInstanceField;
+  baseInstanceMethod() { return 'base method output'; }
+}
+
+class SubClassWithInstanceField extends ClassWithInstanceField {
+  subInstanceField = super.baseInstanceMethod();
+}
+
+const base = new ClassWithInstanceField();
+const sub = new SubClassWithInstanceField();
+
+console.log(base.anotherBaseInstanceField);
+// Ожидаемый вывод: "base field"
+
+console.log(sub.subInstanceField);
+// Ожидаемый вывод: "base method output"
+ +

Публичные методы

+ +

Публичные статические методы

+ +

Ключевое слово static объявляет статический метод класса. Статические методы не вызываются из экземпляра, вместо этого они вызывается из самого класса. Чаще всего это какие-либо служебные функции, такие как функции создания или копирования объектов.

+ +

{{EmbedInteractiveExample("pages/js/classes-static.html")}}

+ + + +

Статические методы добавляются в конструктор класса с помощью Object.defineProperty во время его создания. Эти методы - изменяемые, неперечисляемые и настраеваемые свойства объекта.

+ +

Публичные методы экземпляра

+ +

Как и следует из названия, публичные методы экземпляра это методы, доступные для вызова из экземпляров.

+ +
class ClassWithPublicInstanceMethod {
+  publicMethod() {
+    return 'hello world';
+  }
+}
+
+const instance = new ClassWithPublicInstanceMethod();
+console.log(instance.publicMethod());
+// Ожидаемый вывод: "hello worl​d"
+ +

Публичные методы добавляются в прототип класса во время его создания с помощью Object.defineProperty. Они изменяемы, неперечисляемы и настраиваемы.

+ +

Вы можете использовать генераторы, асинхронные функции и асинхронные генераторы.

+ +
class ClassWithFancyMethods {
+  *generatorMethod() { }
+  async asyncMethod() { }
+  async *asyncGeneratorMethod() { }
+}
+ +

Внутри методов экземпляра, this ссылается на сам экземпляр.
+ В классах наследниках, super дает доступ к прототипу базового класса, позволяя вызывать его методы.

+ +
class BaseClass {
+  msg = 'hello world';
+  basePublicMethod() {
+    return this.msg;
+  }
+}
+
+class SubClass extends BaseClass {
+  subPublicMethod() {
+    return super.basePublicMethod();
+  }
+}
+
+const instance = new SubClass();
+console.log(instance.subPublicMethod());
+// Ожидаемый вывод: "hello worl​d"
+
+ +

Геттеры и сеттеры это специальные методы, которые привязаны к свойствам класса и которые вызываются, когда к свойсту обращаются или записывают. Используйте get и set для объявления публичных геттеров и сеттеров экземпляра.

+ +
class ClassWithGetSet {
+  #msg = 'hello world';
+  get msg() {
+    return this.#msg;
+  }
+  set msg(x) {
+    this.#msg = `hello ${x}`;
+  }
+}
+
+const instance = new ClassWithGetSet();
+console.log(instance.msg);
+// Ожидаемый вывод: "hello worl​d"
+
+instance.msg = 'cake';
+console.log(instance.msg);
+// Ожидаемый вывод: "hello cake"
+
+ +

Приватные поля

+ +

Приватные статические поля

+ +

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

+ +

Также сохраняется ограничение на вызов статических полей только внутри статических методов.

+ +
class ClassWithPrivateStaticField {
+  static #PRIVATE_STATIC_FIELD;
+
+  static publicStaticMethod() {
+    ClassWithPrivateStaticField.#PRIVATE_STATIC_FIELD = 42;
+    return ClassWithPrivateStaticField.#PRIVATE_STATIC_FIELD;
+  }
+}
+
+assert(ClassWithPrivateStaticField.publicStaticMethod() === 42);
+ +

Приватные статические поля добавляются в конструктор на этапе оценки класса.

+ +

Существует ограничение происхождения приватных статических полей. Только класс, который объявляет приватное статическое поле, может обращаться к нему. Это может привести к неожиданному поведению при использовании this.

+ +
class BaseClassWithPrivateStaticField {
+  static #PRIVATE_STATIC_FIELD;
+
+  static basePublicStaticMethod() {
+    this.#PRIVATE_STATIC_FIELD = 42;
+    return this.#PRIVATE_STATIC_FIELD;
+  }
+}
+
+class SubClass extends BaseClassWithPrivateStaticField { }
+
+assertThrows(() => SubClass.basePublicStaticMethod(), TypeError);
+
+ +

Приватные поля экземпляра объекта

+ +

Приватные поля объекта объявляются как # names ( произносятся как "hash names"), которые являются идентификаторами с префиксом #.  # является частью самого имени и также используется для объявления и доступа.

+ +

Инкапсуляция обеспечивается языком. Ссылка на # names вне области видимости является синтаксической ошибкой.

+ +
class ClassWithPrivateField {
+  #privateField;
+
+  constructor() {
+    this.#privateField = 42;
+    this.#randomField = 666; # Syntax error
+  }
+}
+
+const instance = new ClassWithPrivateField();
+instance.#privateField === 42; // Syntax error
+
+ +

Приватные методы

+ +

Приватные статические методы

+ +

Как и публичные методы, приватные статические методы вызываются в классе, а не в экземплярах класса. Как и приватные статические поля, они доступны только из объявления класса.

+ +

Приватные статические методы могут быть генераторами, асинхронными функциями и асинхронными генераторами.

+ +
class ClassWithPrivateStaticMethod {
+    static #privateStaticMethod() {
+        return 42;
+    }
+
+    static publicStaticMethod() {
+        return ClassWithPrivateStaticMethod.#privateStaticMethod();
+    }
+}
+
+assert(ClassWithPrivateStaticField.publicStaticMethod() === 42);
+
+ +

Приватные методы экземпляра объекта

+ +

Приватные методы экземпляра объекта являются методами, доступными в экземплярах класса чей доступ ограничен так же, как и приватные поля экземпляра объекта.

+ +
class ClassWithPrivateMethod {
+  #privateMethod() {
+    return 'hello world';
+  }
+
+  getPrivateMessage() {
+      return #privateMethod();
+  }
+}
+
+const instance = new ClassWithPrivateMethod();
+console.log(instance.getPrivateMessage());
+// expected output: "hello worl​d"
+ +

Приватные методы экземпляра объекта могут быть генераторами, асинхронными функциями и асинхронными генераторами. Также возможны приватные геттеры и сеттеры:

+ +
class ClassWithPrivateAccessor {
+  #message;
+
+  get #decoratedMessage() {
+    return `✨${this.#message}✨`;
+  }
+  set #decoratedMessage(msg) {
+    this.#message = msg;
+  }
+
+  constructor() {
+    this.#decoratedMessage = 'hello world';
+    console.log(this.#decoratedMessage);
+  }
+}
+
+new ClassWithPrivateAccessor();
+// expected output: "✨hello worl​d✨"
+
+ +

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

+ +

Публичные поля класса

+ + + +

{{Compat("javascript.classes.public_class_fields")}}

+ +

Приватные поля класса

+ + + +

{{Compat("javascript.classes.private_class_fields")}}

+ +

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

+ + diff --git "a/files/ru/web/javascript/reference/classes/\320\277\321\200\320\270\320\262\320\260\321\202\320\275\321\213\320\265_\320\277\320\276\320\273\321\217_\320\272\320\273\320\260\321\201\321\201\320\260/index.html" "b/files/ru/web/javascript/reference/classes/\320\277\321\200\320\270\320\262\320\260\321\202\320\275\321\213\320\265_\320\277\320\276\320\273\321\217_\320\272\320\273\320\260\321\201\321\201\320\260/index.html" deleted file mode 100644 index 09fe2505e2..0000000000 --- "a/files/ru/web/javascript/reference/classes/\320\277\321\200\320\270\320\262\320\260\321\202\320\275\321\213\320\265_\320\277\320\276\320\273\321\217_\320\272\320\273\320\260\321\201\321\201\320\260/index.html" +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: Приватные поля класса -slug: Web/JavaScript/Reference/Classes/Приватные_поля_класса -translation_of: Web/JavaScript/Reference/Classes/Private_class_fields ---- -
{{JsSidebar("Classes")}}
- -

Свойства класса по умолчанию являются общедоступными и могут быть рассмотрены или изменены вне класса. Тем не менее, есть экспериментальное предложение, позволяющее определить приватные поля класса, используя префикс хэша #.

- -

Синтаксис

- -
class ClassWithPrivateField {
-  #privateField
-}
-
-class ClassWithPrivateMethod {
-  #privateMethod() {
-    return 'hello world'
- }
-}
-
-class ClassWithPrivateStaticField {
-  static #PRIVATE_STATIC_FIELD
-}
-
- -

Примеры

- -

Приватные статические поля

- -

Приватные поля доступны в конструкторе класса изнутри самой декларации класса.

- -

Ограничение статических переменных, вызываемых только статическими методами, все еще сохраняется.

- -
class ClassWithPrivateStaticField {
-  static #PRIVATE_STATIC_FIELD
-
-  static publicStaticMethod() {
-    ClassWithPrivateStaticField.#PRIVATE_STATIC_FIELD = 42
-    return ClassWithPrivateStaticField.#PRIVATE_STATIC_FIELD
-  }
-}
-
-console.assert(ClassWithPrivateStaticField.publicStaticMethod() === 42)
- -

Приватные статические поля добавляются в конструктор класса во время обработки класса.

- -

Существует ограничение по происхождению частных статических полей. Только класс, который определяет приватное статическое поле, может получить доступ к этому полю.

- -

Это может привести к неожиданному поведению при использовании this.

- -
class BaseClassWithPrivateStaticField {
-  static #PRIVATE_STATIC_FIELD
-
-  static basePublicStaticMethod() {
-    this.#PRIVATE_STATIC_FIELD = 42
-    return this.#PRIVATE_STATIC_FIELD
-  }
-}
-
-class SubClass extends BaseClassWithPrivateStaticField { }
-
-let error = null
-
-try {
-  SubClass.basePublicStaticMethod()
-} catch(e) { error = e}
-
-console.assert(error instanceof TypeError)
-
- -

Приватные поля экземпляров

- -

Приватные поля экзмепляров объявляются #имя (произносится как "хэш нэймс"), которые идентифицируются префиксом #. # является частью имени, а также используется для объявления и доступа.

- -

Инкапсуляция обеспечивается языком. Обращение к # именам вне области видимости является синтаксической ошибкой.

- -
class ClassWithPrivateField {
-  #privateField
-
-  constructor() {
-    this.#privateField = 42
-    this.#randomField = 666 // Syntax error
-  }
-}
-
-const instance = new ClassWithPrivateField()
-instance.#privateField === 42 // Syntax error
-
- -

Приватные методы

- -

Приватные статические методы

- -

Приватные статические методы

- -

Как и их публичный эквивалент, приватные статические методы вызываются на самом классе, а не на экземплярах класса. Как и приватные статические поля, они доступны только изнутри объявления класса.

- -

Приватные статические методы могут быть генераторами, асинхронными функциями и асинхронными функциями-генераторами.

- -
class ClassWithPrivateStaticMethod {
-    static #privateStaticMethod() {
-        return 42
-    }
-
-    static publicStaticMethod1() {
-        return ClassWithPrivateStaticMethod.#privateStaticMethod();
-    }
-
-    static publicStaticMethod2() {
-        return this.#privateStaticMethod();
-    }
-}
-
-console.assert(ClassWithPrivateStaticMethod.publicStaticMethod1() === 42);
-console.assert(ClassWithPrivateStaticMethod.publicStaticMethod2() === 42);
-
- -

Это может привести к неожиданному поведению при его использовании this. В следующем примере this относится к классу Derived (а не к классу Base), когда мы пытаемся вызвать Derived.publicStaticMethod2(), и, таким образом, имеет такое же "ограничение по происхождению", как упоминалось выше:

- -
class Base {
-    static #privateStaticMethod() {
-        return 42;
-    }
-    static publicStaticMethod1() {
-        return Base.#privateStaticMethod();
-    }
-    static publicStaticMethod2() {
-        return this.#privateStaticMethod();
-    }
-}
-
-class Derived extends Base {}
-
-console.log(Derived.publicStaticMethod1()); // 42
-console.log(Derived.publicStaticMethod2()); // TypeError
-
- -

Приватные методы экземпляров(instance)

- -

Приватные методы экземпляров это методы, доступные у экземпляров класса, доступ к которым запрещен также, как у приватных полей класса.

- -
class ClassWithPrivateMethod {
-  #privateMethod() {
-    return 'hello world'
-  }
-
-  getPrivateMessage() {
-      return this.#privateMethod()
-  }
-}
-
-const instance = new ClassWithPrivateMethod()
-console.log(instance.getPrivateMessage())
-// expected output: "hello worl​d"
- -

Приватные методы экземпляров могут быть генератором, async, или функциями async генератора. Приватные геттеры и сеттеры также возможны:

- -
class ClassWithPrivateAccessor {
-  #message
-
-  get #decoratedMessage() {
-    return `✨${this.#message}✨`
-  }
-  set #decoratedMessage(msg) {
-    this.#message = msg
-  }
-
-  constructor() {
-    this.#decoratedMessage = 'hello world'
-    console.log(this.#decoratedMessage)
-  }
-}
-
-new ClassWithPrivateAccessor();
-// expected output: "✨hello worl​d✨"
-
- -

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

- - - - - - - - - - - - -
Specification
{{SpecName('Public and private instance fields', '#prod-FieldDefinition', 'FieldDefinition')}}
- -

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

- - - -

{{Compat("javascript.classes.private_class_fields")}}

- -

См. также

- - diff --git a/files/ru/web/javascript/reference/errors/var_hides_argument/index.html b/files/ru/web/javascript/reference/errors/var_hides_argument/index.html new file mode 100644 index 0000000000..85ad505cbd --- /dev/null +++ b/files/ru/web/javascript/reference/errors/var_hides_argument/index.html @@ -0,0 +1,60 @@ +--- +title: 'TypeError: переменная "x" переопределяет аргумент' +slug: Web/JavaScript/Reference/Errors/Переменные_скрывают_аргумент +tags: + - Errors + - JavaScript + - Strict Mode + - TypeError +translation_of: Web/JavaScript/Reference/Errors/Var_hides_argument +--- +
{{jsSidebar("Errors")}}
+ +

Сообщение

+ +
TypeError: переменная "x" повторно объявляет аргумент (Firefox)
+
+ +

Тип ошибки

+ +

{{jsxref("TypeError")}} предупреждение только в строгом режиме.

+ +

Что пошло не так?

+ +

 

+ +

То же имя переменной происходит в качестве параметра функции, и затем повторно объявляется с помощью назначения var в теле функции. Это может быть конфликт имен, поэтому JavaScript предупреждает об этом.

+ +

Эта ошибка возникает как предупреждение только в коде строгого режима. В нестрогом коде повторное объявление игнорируется.

+ +

 

+ +

Примеры

+ +

Неправильные примеры

+ +

В этом случае переменная "arg" объявляет аргумент повторно.

+ +
'use strict';
+
+function f(arg) {
+  var arg = 'foo';
+}
+
+ +

Правильные примеры

+ +

Чтобы исправить это предупреждение, оператор var можно просто опустить, так как переменная уже существует. В других случаях можно переименовать параметр функции или имя переменной. 

+ +
'use strict';
+
+function f(arg) {
+  arg = 'foo';
+}
+
+ +

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

+ + diff --git "a/files/ru/web/javascript/reference/errors/\320\277\320\265\321\200\320\265\320\274\320\265\320\275\320\275\321\213\320\265_\321\201\320\272\321\200\321\213\320\262\320\260\321\216\321\202_\320\260\321\200\320\263\321\203\320\274\320\265\320\275\321\202/index.html" "b/files/ru/web/javascript/reference/errors/\320\277\320\265\321\200\320\265\320\274\320\265\320\275\320\275\321\213\320\265_\321\201\320\272\321\200\321\213\320\262\320\260\321\216\321\202_\320\260\321\200\320\263\321\203\320\274\320\265\320\275\321\202/index.html" deleted file mode 100644 index 85ad505cbd..0000000000 --- "a/files/ru/web/javascript/reference/errors/\320\277\320\265\321\200\320\265\320\274\320\265\320\275\320\275\321\213\320\265_\321\201\320\272\321\200\321\213\320\262\320\260\321\216\321\202_\320\260\321\200\320\263\321\203\320\274\320\265\320\275\321\202/index.html" +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: 'TypeError: переменная "x" переопределяет аргумент' -slug: Web/JavaScript/Reference/Errors/Переменные_скрывают_аргумент -tags: - - Errors - - JavaScript - - Strict Mode - - TypeError -translation_of: Web/JavaScript/Reference/Errors/Var_hides_argument ---- -
{{jsSidebar("Errors")}}
- -

Сообщение

- -
TypeError: переменная "x" повторно объявляет аргумент (Firefox)
-
- -

Тип ошибки

- -

{{jsxref("TypeError")}} предупреждение только в строгом режиме.

- -

Что пошло не так?

- -

 

- -

То же имя переменной происходит в качестве параметра функции, и затем повторно объявляется с помощью назначения var в теле функции. Это может быть конфликт имен, поэтому JavaScript предупреждает об этом.

- -

Эта ошибка возникает как предупреждение только в коде строгого режима. В нестрогом коде повторное объявление игнорируется.

- -

 

- -

Примеры

- -

Неправильные примеры

- -

В этом случае переменная "arg" объявляет аргумент повторно.

- -
'use strict';
-
-function f(arg) {
-  var arg = 'foo';
-}
-
- -

Правильные примеры

- -

Чтобы исправить это предупреждение, оператор var можно просто опустить, так как переменная уже существует. В других случаях можно переименовать параметр функции или имя переменной. 

- -
'use strict';
-
-function f(arg) {
-  arg = 'foo';
-}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/functions/method_definitions/index.html b/files/ru/web/javascript/reference/functions/method_definitions/index.html new file mode 100644 index 0000000000..2f50dfe53f --- /dev/null +++ b/files/ru/web/javascript/reference/functions/method_definitions/index.html @@ -0,0 +1,191 @@ +--- +title: Определение методов +slug: Web/JavaScript/Reference/Functions/Определиние_методов +translation_of: Web/JavaScript/Reference/Functions/Method_definitions +--- +
{{JsSidebar("Functions")}}
+ +

Начиная с ECMAScript 6, существует короткий синтаксис для определения методов в инициализаторе объекта. По сути, это сокращение для функции, которая назначена имени метода.

+ +

Синтаксис

+ +
var obj = {
+  property([parameters]) {},
+  get property() {},
+  set property(value) {},
+  * generator() {}
+};
+
+ +

Описание

+ +

Короткий синтаксис похожий на синтаксис getter'ов и setter'ов представленых в ECMAScript 5.

+ +

Следующий код:

+ +
var obj = {
+  foo: function() {},
+  bar: function() {}
+};
+ +

Вы теперь можете сократить до:

+ +
var obj = {
+  foo() {},
+  bar() {}
+};
+ +

Сокращение методов-генераторов

+ +

Методы-генераторы также могут быть определены используя короткий синтаксис. Обратите внимание, что звездочка (*) в коротком синтаксисе должна быть перед именем свойства генератора. То есть, * g(){} будет работать, а g *(){} не будет.

+ +
// Используя свойство с именем (pre-ES6)
+var obj2 = {
+  g: function*() {
+    var index = 0;
+    while(true)
+      yield index++;
+  }
+};
+
+// Тот же объект используя короткий синтаксис
+var obj2 = {
+  * g() {
+    var index = 0;
+    while(true)
+      yield index++;
+  }
+};
+
+var it = obj2.g();
+console.log(it.next().value); // 0
+console.log(it.next().value); // 1
+ +

Определения методов (ES6) не могут быть конструкторами

+ +

Все определения методов кроме методов-генераторов не могут быть конструкторами и будут выбрасывать {{jsxref("TypeError")}} если вы попытаетесь создать их экземпляр.

+ +
var obj = {
+  method() {},
+};
+new obj.method; // TypeError: obj.method is not a constructor
+
+var obj = {
+  * g() {}
+};
+new obj.g; // Генератор
+
+ +

Примеры

+ +

Простой тестовый пример

+ +
var obj = {
+  a : "foo",
+  b(){ return this.a; }
+};
+console.log(obj.b()); // "foo"
+
+ +

Вычисляемые имена свойств

+ +

Короткий синтаксис также поддерживает вычисляемые имена свойств.

+ +
var bar = {
+  foo0 : function (){return 0;},
+  foo1(){return 1;},
+  ["foo" + 2](){return 2;},
+};
+
+console.log(bar.foo0()); // 0
+console.log(bar.foo1()); // 1
+console.log(bar.foo2()); // 2
+ +

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

+ + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES6', '#sec-method-definitions', 'Method definitions')}}{{Spec2('ES6')}}Изначальное определение.
+ +

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

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Method definition shorthand{{CompatChrome("39")}}{{CompatGeckoDesktop("34")}}{{CompatNo}}{{CompatOpera("26")}}{{CompatNo}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Method definition shorthand{{CompatNo}}{{CompatNo}}{{CompatGeckoMobile("34")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
+
+ +

 

+ +

SpiderMonkey-specific notes

+ + + +

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

+ + diff --git "a/files/ru/web/javascript/reference/functions/\320\276\320\277\321\200\320\265\320\264\320\265\320\273\320\270\320\275\320\270\320\265_\320\274\320\265\321\202\320\276\320\264\320\276\320\262/index.html" "b/files/ru/web/javascript/reference/functions/\320\276\320\277\321\200\320\265\320\264\320\265\320\273\320\270\320\275\320\270\320\265_\320\274\320\265\321\202\320\276\320\264\320\276\320\262/index.html" deleted file mode 100644 index 2f50dfe53f..0000000000 --- "a/files/ru/web/javascript/reference/functions/\320\276\320\277\321\200\320\265\320\264\320\265\320\273\320\270\320\275\320\270\320\265_\320\274\320\265\321\202\320\276\320\264\320\276\320\262/index.html" +++ /dev/null @@ -1,191 +0,0 @@ ---- -title: Определение методов -slug: Web/JavaScript/Reference/Functions/Определиние_методов -translation_of: Web/JavaScript/Reference/Functions/Method_definitions ---- -
{{JsSidebar("Functions")}}
- -

Начиная с ECMAScript 6, существует короткий синтаксис для определения методов в инициализаторе объекта. По сути, это сокращение для функции, которая назначена имени метода.

- -

Синтаксис

- -
var obj = {
-  property([parameters]) {},
-  get property() {},
-  set property(value) {},
-  * generator() {}
-};
-
- -

Описание

- -

Короткий синтаксис похожий на синтаксис getter'ов и setter'ов представленых в ECMAScript 5.

- -

Следующий код:

- -
var obj = {
-  foo: function() {},
-  bar: function() {}
-};
- -

Вы теперь можете сократить до:

- -
var obj = {
-  foo() {},
-  bar() {}
-};
- -

Сокращение методов-генераторов

- -

Методы-генераторы также могут быть определены используя короткий синтаксис. Обратите внимание, что звездочка (*) в коротком синтаксисе должна быть перед именем свойства генератора. То есть, * g(){} будет работать, а g *(){} не будет.

- -
// Используя свойство с именем (pre-ES6)
-var obj2 = {
-  g: function*() {
-    var index = 0;
-    while(true)
-      yield index++;
-  }
-};
-
-// Тот же объект используя короткий синтаксис
-var obj2 = {
-  * g() {
-    var index = 0;
-    while(true)
-      yield index++;
-  }
-};
-
-var it = obj2.g();
-console.log(it.next().value); // 0
-console.log(it.next().value); // 1
- -

Определения методов (ES6) не могут быть конструкторами

- -

Все определения методов кроме методов-генераторов не могут быть конструкторами и будут выбрасывать {{jsxref("TypeError")}} если вы попытаетесь создать их экземпляр.

- -
var obj = {
-  method() {},
-};
-new obj.method; // TypeError: obj.method is not a constructor
-
-var obj = {
-  * g() {}
-};
-new obj.g; // Генератор
-
- -

Примеры

- -

Простой тестовый пример

- -
var obj = {
-  a : "foo",
-  b(){ return this.a; }
-};
-console.log(obj.b()); // "foo"
-
- -

Вычисляемые имена свойств

- -

Короткий синтаксис также поддерживает вычисляемые имена свойств.

- -
var bar = {
-  foo0 : function (){return 0;},
-  foo1(){return 1;},
-  ["foo" + 2](){return 2;},
-};
-
-console.log(bar.foo0()); // 0
-console.log(bar.foo1()); // 1
-console.log(bar.foo2()); // 2
- -

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

- - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES6', '#sec-method-definitions', 'Method definitions')}}{{Spec2('ES6')}}Изначальное определение.
- -

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

- -
{{CompatibilityTable}}
- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Method definition shorthand{{CompatChrome("39")}}{{CompatGeckoDesktop("34")}}{{CompatNo}}{{CompatOpera("26")}}{{CompatNo}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Method definition shorthand{{CompatNo}}{{CompatNo}}{{CompatGeckoMobile("34")}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
- -

 

- -

SpiderMonkey-specific notes

- - - -

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

- - 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 ---- -
{{JSRef("Global_Objects", "Array")}}
- -

Сводка

- -

Свойство Array.prototype представляет прототип для конструктора {{jsxref("Global_Objects/Array", "Array", "массива")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

- -

Экземпляры Array наследуются от Array.prototype. Как и с остальными конструкторами, вы можете изменять прототип конструктора объекта для применения изменений ко всем экземплярам класса Array.

- -

Небольшой факт: Array.prototype сам является экземпляром Array:

- -
Array.isArray(Array.prototype); // true
- -

Свойства

- -
-
Array.prototype.constructor
-
Определяет функцию, создающую прототип объекта.
-
{{jsxref("Array.prototype.length")}}
-
Отражает количество элементов в массиве.
-
- -

Методы

- -

Методы изменения

- -

Эти методы изменяют массив:

- -
-
{{jsxref("Array.prototype.copyWithin()")}} {{experimental_inline}}
-
Копирует последовательность элементов массива внутри массива.
-
{{jsxref("Array.prototype.fill()")}} {{experimental_inline}}
-
Заполняет все элементы массива от начального индекса до конечного индекса указанным значением.
-
{{jsxref("Array.prototype.pop()")}}
-
Удаляет последний элемент из массива и возвращает его.
-
{{jsxref("Array.prototype.push()")}}
-
Добавляет один или более элементов в конец массива и возвращает новую длину массива.
-
{{jsxref("Array.prototype.reverse()")}}
-
Переворачивает порядок элементов в массиве — первый элемент становится последним, а последний — первым.
-
{{jsxref("Array.prototype.shift()")}}
-
Удаляет первый элемент из массива и возвращает его.
-
{{jsxref("Array.prototype.sort()")}}
-
Сортирует элементы массива на месте и возвращает отсортированный массив.
-
{{jsxref("Array.prototype.splice()")}}
-
Добавляет и/или удаляет элементы из массива.
-
{{jsxref("Array.prototype.unshift()")}}
-
Добавляет один или более элементов в начало массива и возвращает новую длину массива.
-
- -

Методы доступа

- -

Эти методы не изменяют массив, а просто возвращают его в ином представлении.

- -
-
{{jsxref("Array.prototype.concat()")}}
-
Возвращает новый массив, состоящий из данного массива, соединённого с другим массивом и/или значением (списком массивов/значений).
-
{{jsxref("Array.prototype.includes()")}} {{experimental_inline}}
-
Определяет, содержится ли в массиве указанный элемент, возвращая, соответственно, true или false.
-
{{jsxref("Array.prototype.join()")}}
-
Объединяет все элементы массива в строку.
-
{{jsxref("Array.prototype.slice()")}}
-
Извлекает диапазон значений и возвращает его в виде нового массива.
-
{{jsxref("Array.prototype.toSource()")}} {{non-standard_inline}}
-
Возвращает литеральное представление указанного массива; вы можете использовать это значение для создания нового массива. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.
-
{{jsxref("Array.prototype.toString()")}}
-
Возвращает строковое представление массива и его элементов. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.
-
{{jsxref("Array.prototype.toLocaleString()")}}
-
Возвращает локализованное строковое представление массива и его элементов. Переопределяет метод {{jsxref("Object.prototype.toLocaleString()")}}.
-
{{jsxref("Array.prototype.indexOf()")}}
-
Возвращает первый (наименьший) индекс элемента внутри массива, равный указанному значению; или -1, если значение не найдено.
-
{{jsxref("Array.prototype.lastIndexOf()")}}
-
Возвращает последний (наибольший) индекс элемента внутри массива, равный указанному значению; или -1, если значение не найдено.
-
- -

Методы обхода

- -

Некоторые методы принимают в качестве аргументов функции, вызываемые при обработке массива. Когда вызываются эти методы, достаётся длина массива, и любой элемент, добавленный свыше этой длины изнутри функции обратного вызова не посещается. Другие изменения в массиве (установка значения или удаление элемента) могут повлиять на результаты операции, если изменённый элемент метод посещает после изменения. Хотя специфическое поведение этих методов в таких случаях хорошо определено, вы не должны на него полагаться, чтобы не запутывать других людей, читающих ваш код. Если вам нужно изменить массив, лучше вместо этого скопируйте его в новый массив.

- -
-
{{jsxref("Array.prototype.forEach()")}}
-
Вызывает функцию для каждого элемента в массиве.
-
{{jsxref("Array.prototype.entries()")}} {{experimental_inline}}
-
Возвращает новый объект итератора массива Array Iterator, содержащий пары ключ / значение для каждого индекса в массиве.
-
{{jsxref("Array.prototype.every()")}}
-
Возвращает true, если каждый элемент в массиве удовлетворяет условию проверяющей функции.
-
{{jsxref("Array.prototype.some()")}}
-
Возвращает true, если хотя бы один элемент в массиве удовлетворяет условию проверяющей функции.
-
{{jsxref("Array.prototype.filter()")}}
-
Создаёт новый массив со всеми элементами этого массива, для которых функция фильтрации возвращает true.
-
{{jsxref("Array.prototype.find()")}} {{experimental_inline}}
-
Возвращает искомое значение в массиве, если элемент в массиве удовлетворяет условию проверяющей функции или {{jsxref("Global_Objects/undefined", "undefined")}}, если такое значение не найдено.
-
{{jsxref("Array.prototype.findIndex()")}} {{experimental_inline}}
-
Возвращает искомый индекс в массиве, если элемент в массиве удовлетворяет условию проверяющей функции или -1, если такое значение не найдено.
-
{{jsxref("Array.prototype.keys()")}} {{experimental_inline}}
-
Возвращает новый итератор массива, содержащий ключи каждого индекса в массиве.
-
{{jsxref("Array.prototype.map()")}}
-
Создаёт новый массив с результатами вызова указанной функции на каждом элементе данного массива.
-
{{jsxref("Array.prototype.reduce()")}}
-
Применяет функцию к аккумулятору и каждому значению массива (слева-направо), сводя его к одному значению.
-
{{jsxref("Array.prototype.reduceRight()")}}
-
Применяет функцию к аккумулятору и каждому значению массива (справа-налево), сводя его к одному значению.
-
{{jsxref("Array.prototype.values()")}} {{experimental_inline}}
-
Возвращает новый объект итератора массива Array Iterator, содержащий значения для каждого индекса в массиве.
-
{{jsxref("Array.prototype.@@iterator()", "Array.prototype[@@iterator]()")}} {{experimental_inline}}
-
Возвращает новый объект итератора массива Array Iterator, содержащий значения для каждого индекса в массиве.
-
- -

Общие методы

- -

Многие методы JavaScript-массива спроектированы таким образом, чтобы иметь возможность применяться ко всем объектам, «выглядящим похоже» на массивы. То есть, они могут использоваться на любом объекте, имеющим свойство length и к элементам которого можно получить доступ через числовые имена свойств (как при индексации: array[5]). TODO: предоставить примеры с Array.prototype.forEach.call и добавлением методов к объекту, как сделано для {{jsxref("Global_Objects/JavaArray", "JavaArray")}} или {{jsxref("Global_Objects/String", "String")}}. Некоторые методы, например {{jsxref("Array.join", "join")}}, только читают свойство length и числовые свойства объекта, на котором они вызываются. Другие, вроде {{jsxref("Array.reverse", "reverse")}} требуют, чтобы числовые свойства и свойство length объекта были изменяемыми; эти методы не могут вызываться на объектах вроде {{jsxref("Global_Objects/String", "String")}}, которые не позволяют установку своего свойства length или синтезирование числовых свойств.

- -

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

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
ECMAScript 1-е издание.СтандартИзначальное определение.
{{SpecName('ES5.1', '#sec-15.4.3.1', 'Array.prototype')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-array.prototype', 'Array.prototype')}}{{Spec2('ES6')}} 
- -

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

- -

 

- - - -

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

- -

 

- -
 
- -

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

- - diff --git a/files/ru/web/javascript/reference/global_objects/asyncfunction/prototype/index.html b/files/ru/web/javascript/reference/global_objects/asyncfunction/prototype/index.html deleted file mode 100644 index 9d0c21f241..0000000000 --- a/files/ru/web/javascript/reference/global_objects/asyncfunction/prototype/index.html +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: AsyncFunction.prototype -slug: Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype -translation_of: Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype ---- -
{{JSRef}}
- -

Свойство AsyncFunction.prototype представляет прототип объекта  {{jsxref("AsyncFunction")}} .

- -

Описание

- -

Объект {{jsxref("AsyncFunction")}} наследуется от AsyncFunction.prototype. AsyncFunction.prototype не может быть модифицирован.

- -

Свойства

- -
-
AsyncFunction.constructor
-
Начальное значение {{jsxref("AsyncFunction")}}.
-
AsyncFunction.prototype[@@toStringTag]
-
Возвращает "AsyncFunction".
-
- -

Specifications

- - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ESDraft', '#sec-async-function-constructor-prototype', 'AsyncFunction.prototype')}}{{Spec2('ESDraft')}}Initial definition in ES2017.
- -

Browser compatibility

- -
- - -

{{Compat("javascript.builtins.AsyncFunction.prototype")}}

-
- -

See also

- - diff --git a/files/ru/web/javascript/reference/global_objects/boolean/prototype/index.html b/files/ru/web/javascript/reference/global_objects/boolean/prototype/index.html deleted file mode 100644 index f0188080f1..0000000000 --- a/files/ru/web/javascript/reference/global_objects/boolean/prototype/index.html +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: Boolean.prototype -slug: Web/JavaScript/Reference/Global_Objects/Boolean/prototype -tags: - - Boolean - - JavaScript - - Property - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Boolean -translation_of_original: Web/JavaScript/Reference/Global_Objects/Boolean/prototype ---- -
{{JSRef("Global_Objects", "Boolean")}}
- -

Сводка

-

Свойство Boolean.prototype представляет прототип конструктора объекта {{jsxref("Global_Objects/Boolean", "Boolean")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Экземпляры объекта {{jsxref("Global_Objects/Boolean", "Boolean")}} наследуются от Boolean.prototype. Вы можете использовать протитип конструктора объекта для добавления свойств или методов ко всем экземплярам объекта {{jsxref("Global_Objects/Boolean", "Boolean")}}.

- -

Свойства

-
-
Boolean.prototype.constructor
-
Возвращает функцию, создающую экземпляр прототипа. По умолчанию, это функция {{jsxref("Global_Objects/Boolean", "Boolean")}}.
-
-
{{jsOverrides("Object", "properties", "constructor")}}
- -

Методы

-
-
{{jsxref("Boolean.prototype.toSource()")}} {{non-standard_inline}}
-
Возвращает строку, содержащую исходный код объекта {{jsxref("Global_Objects/Boolean", "Boolean")}}; вы можете использовать эту строку для создания эквивалентного объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.
-
{{jsxref("Boolean.prototype.toString()")}}
-
Возвращает строку "true" или "false", в зависимости от значения объекта. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.
-
{{jsxref("Boolean.prototype.valueOf()")}}
-
Возвращает примитивное значение объекта {{jsxref("Global_Objects/Boolean", "Boolean")}}. Переопределяет метод {{jsxref("Object.prototype.valueOf()")}}.
-
-
{{jsOverrides("Object", "methods", "toSource", "toString", "valueOf")}}
- -

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

- - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 1-е издание.СтандартИзначальное определение. Реализована в JavaScript 1.0.
{{SpecName('ES5.1', '#sec-15.6.3.1', 'Boolean.prototype')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-boolean.prototype', 'Boolean.prototype')}}{{Spec2('ES6')}} 
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
diff --git a/files/ru/web/javascript/reference/global_objects/date/prototype/index.html b/files/ru/web/javascript/reference/global_objects/date/prototype/index.html deleted file mode 100644 index 956a7555a1..0000000000 --- a/files/ru/web/javascript/reference/global_objects/date/prototype/index.html +++ /dev/null @@ -1,229 +0,0 @@ ---- -title: Date.prototype -slug: Web/JavaScript/Reference/Global_Objects/Date/prototype -tags: - - Date - - JavaScript - - Property - - Prototype - - Reference - - Référence(2) -translation_of: Web/JavaScript/Reference/Global_Objects/Date -translation_of_original: Web/JavaScript/Reference/Global_Objects/Date/prototype ---- -
{{JSRef("Global_Objects", "Date")}}
- -

Сводка

- -

Свойство Date.prototype представляет прототип конструктора {{jsxref("Global_Objects/Date", "Date")}}.

- -
{{js_property_attributes(0, 0, 1)}}
- -

Описание

- -

Все экземпляры {{jsxref("Global_Objects/Date", "Date")}} наследуются от Date.prototype. Объект прототипа конструктора {{jsxref("Global_Objects/Date", "Date")}} может быть изменён для затрагивания всех экземпляров объекта {{jsxref("Global_Objects/Date", "Date")}}.

- -

Для совместимости с вычислениями тысячелетия (другими словами, для учёта 2000 года), вы всегда должны указывать полный год; например, использовать число 1998, а не 98. Чтобы помочь вам определить полный год, JavaScript включает методы {{jsxref("Date.prototype.getFullYear()", "getFullYear()")}}, {{jsxref("Date.prototype.setFullYear()", "setFullYear()")}}, {{jsxref("Date.prototype.getUTCFullYear()", "getUTCFullYear()")}} и {{jsxref("Date.prototype.setUTCFullYear()", "setUTCFullYear()")}}.

- -

Свойства

- -
-
Date.prototype.constructor
-
Возвращает функцию, создавшую этот экземпляр объекта. По умолчанию ей является объект {{jsxref("Global_Objects/Date", "Date")}}.
-
- -
{{jsOverrides("Object", "properties", "constructor")}}
- -

Методы

- -

Получения значения

- -
-
{{jsxref("Date.prototype.getDate()")}}
-
Возвращает день месяца (1-31) указанной даты по местному времени.
-
{{jsxref("Date.prototype.getDay()")}}
-
Возвращает день недели (0-6) указанной даты по местному времени.
-
{{jsxref("Date.prototype.getFullYear()")}}
-
Возвращает год (4 цифры для 4-х значного года) указанной даты по местному времени.
-
{{jsxref("Date.prototype.getHours()")}}
-
Возвращает часы (0-23) указанной даты по местному времени.
-
{{jsxref("Date.prototype.getMilliseconds()")}}
-
Возвращает миллисекунды (0-999) указанной даты по местному времени.
-
{{jsxref("Date.prototype.getMinutes()")}}
-
Возвращает минуты (0-59) указанной даты по местному времени.
-
{{jsxref("Date.prototype.getMonth()")}}
-
Возвращает месяц (0-11) указанной даты по местному времени.
-
{{jsxref("Date.prototype.getSeconds()")}}
-
Возвращает секунды (0-59) указанной даты по местному времени.
-
{{jsxref("Date.prototype.getTime()")}}
-
Возвращает числовое значение указанной даты как количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC (отрицательное значение для даты до этого момента).
-
{{jsxref("Date.prototype.getTimezoneOffset()")}}
-
Возвращает смещение часового пояса в минутах для текущей локали.
-
{{jsxref("Date.prototype.getUTCDate()")}}
-
Возвращает день месяца (1-31) указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.getUTCDay()")}}
-
Возвращает день недели (0-6) указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.getUTCFullYear()")}}
-
Возвращает год (4 цифры для 4-х значного года) указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.getUTCHours()")}}
-
Возвращает часы (0-23) указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.getUTCMilliseconds()")}}
-
Возвращает миллисекунды (0-999) указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.getUTCMinutes()")}}
-
Возвращает минуты (0-59) указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.getUTCMonth()")}}
-
Возвращает месяц (0-11) указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.getUTCSeconds()")}}
-
Возвращает секунды (0-59) указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.getYear()")}} {{deprecated_inline}}
-
Возвращает год (обычно 2-3 цифры) указанной даты по всемирному координированному времени. Вместо него используйте метод {{jsxref("Date.prototype.getFullYear()", "getFullYear()")}}.
-
- -

Установки значения

- -
-
{{jsxref("Date.prototype.setDate()")}}
-
Устанавливает день месяца указанной даты по местному времени.
-
{{jsxref("Date.prototype.setFullYear()")}}
-
Устанавливает полный год (4 цифры для 4-х значного года) указанной даты по местному времени.
-
{{jsxref("Date.prototype.setHours()")}}
-
Устанавливает часы указанной даты по местному времени.
-
{{jsxref("Date.prototype.setMilliseconds()")}}
-
Устанавливает миллисекунды указанной даты по местному времени.
-
{{jsxref("Date.prototype.setMinutes()")}}
-
Устанавливает минуты указанной даты по местному времени.
-
{{jsxref("Date.prototype.setMonth()")}}
-
Устанавливает месяц указанной даты по местному времени.
-
{{jsxref("Date.prototype.setSeconds()")}}
-
Устанавливает секунды указанной даты по местному времени.
-
{{jsxref("Date.prototype.setTime()")}}
-
Устанавливает объект {{jsxref("Global_Objects/Date", "Date")}} во время, представляемое количеством миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC (отрицательное значение устанавливает даты до этого момента).
-
{{jsxref("Date.prototype.setUTCDate()")}}
-
Устанавливает день месяца указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.setUTCFullYear()")}}
-
Устанавливает полный год (4 цифры для 4-х значного года) указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.setUTCHours()")}}
-
Устанавливает часы указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.setUTCMilliseconds()")}}
-
Устанавливает миллисекунды указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.setUTCMinutes()")}}
-
Устанавливает минуты указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.setUTCMonth()")}}
-
Устанавливает месяц указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.setUTCSeconds()")}}
-
Устанавливает секунды указанной даты по всемирному координированному времени.
-
{{jsxref("Date.prototype.setYear()")}} {{deprecated_inline}}
-
Устанавливает год (обычно 2-3 цифры) указанной даты по всемирному координированному времени. Вместо него используйте метод {{jsxref("Date.prototype.setFullYear()", "setFullYear()")}}.
-
- -

Получения преобразованного значения

- -
-
{{jsxref("Date.prototype.toDateString()")}}
-
Возвращает часть, содержащую только дату объекта {{jsxref("Global_Objects/Date", "Date")}} в качестве человеко-читаемой строки.
-
{{jsxref("Date.prototype.toISOString()")}}
-
Преобразует дату в строку, следуя расширенному формату ISO 8601.
-
{{jsxref("Date.prototype.toJSON()")}}
-
Возвращает строку, представляющую объект {{jsxref("Global_Objects/Date", "Date")}}, используя метод {{jsxref("Date.prototype.toISOString()", "toISOString()")}}. Предназначен для использования методом {{jsxref("JSON.stringify()")}}.
-
{{jsxref("Date.prototype.toGMTString()")}} {{deprecated_inline}}
-
Возвращает строку, представляющую объект {{jsxref("Global_Objects/Date", "Date")}}, на основе часового пояса GMT (всемирное время). Вместо него используйте метод {{jsxref("Date.prototype.toUTCString()", "toUTCString()")}}.
-
{{jsxref("Date.prototype.toLocaleDateString()")}}
-
Возвращает строку с датой, чьё представление зависит от системных настроек локали.
-
{{jsxref("Date.prototype.toLocaleFormat()")}} {{non-standard_inline}}
-
Преобразует дату в строку, используя строку форматирования.
-
{{jsxref("Date.prototype.toLocaleString()")}}
-
Возвращает строку, чьё представление зависит от настроек локали. Переопределяет метод {{jsxref("Object.prototype.toLocaleString()")}}.
-
{{jsxref("Date.prototype.toLocaleTimeString()")}}
-
Возвращает строку со временем, чьё представление зависит от системных настроек локали.
-
{{jsxref("Date.prototype.toSource()")}} {{non-standard_inline}}
-
Возвращает строковое представление исходного кода эквивалентного объекта {{jsxref("Global_Objects/Date", "Date")}}; вы можете использовать это значение для создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.
-
{{jsxref("Date.prototype.toString()")}}
-
Возвращает строковое представление указанного объекта {{jsxref("Global_Objects/Date", "Date")}}. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.
-
{{jsxref("Date.prototype.toTimeString()")}}
-
Возвращает часть, содержащую только время объекта {{jsxref("Global_Objects/Date", "Date")}} в качестве человеко-читаемой строки.
-
{{jsxref("Date.prototype.toUTCString()")}}
-
Преобразует дату в строку, используя часовой пояс UTC.
-
{{jsxref("Date.prototype.valueOf()")}}
-
Возвращает примитивное значение объекта {{jsxref("Global_Objects/Date", "Date")}}. Переопределяет метод {{jsxref("Object.prototype.valueOf()")}}.
-
- -
{{jsOverrides("Object", "methods", "getDate", "getDay", "getFullYear", "getHours", "getMilliseconds", "getMinutes", "getMonth", "getSeconds", "getTime", "getTimezoneOffset", "getUTCDate", "getUTCDay", "getUTCFullYear", "getUTCHours", "getUTCMilliseconds", "getUTCMinutes", "getUTCMonth", "getUTCSeconds", "getYear", "setdate", "setFullYear", "setHours", "setMilliseconds", "setMinutes", "setMontth", "setSeconds", "setTime", "setUTCDate", "setUTCFullYear", "setUTCHours", "setUTCMilliseconds", "setUTCMinutes", "setUTCMonth", "setUTCSeconds", "setYear", "toDateString", "toGMTString", "toLocaleDateString", "toLocaleFormat", "toLocaleString", "toLocaleTimeString", "toSource", "toString", "toTimeString", "toUTCString", "valueOf")}}
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 1-е издание.СтандартИзначальное определение. Реализована в JavaScript 1.1.
{{SpecName('ES5.1', '#sec-15.9.5', 'Date.prototype')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-properties-of-the-date-prototype-object', 'Date.prototype')}}{{Spec2('ES6')}}
- -

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

- -
{{CompatibilityTable}}
- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
diff --git a/files/ru/web/javascript/reference/global_objects/error/prototype/index.html b/files/ru/web/javascript/reference/global_objects/error/prototype/index.html deleted file mode 100644 index 668277c4e0..0000000000 --- a/files/ru/web/javascript/reference/global_objects/error/prototype/index.html +++ /dev/null @@ -1,155 +0,0 @@ ---- -title: Error.prototype -slug: Web/JavaScript/Reference/Global_Objects/Error/prototype -tags: - - Error - - JavaScript - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/Error -translation_of_original: Web/JavaScript/Reference/Global_Objects/Error/prototype ---- -
{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}
- -

Сводка

- -

Свойство Error.prototype представляет прототип конструктора объекта {{jsxref("Global_Objects/Error", "Error")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

- -

Все экземпляры {{jsxref("Global_Objects/Error", "Error")}} и экземпляры {{jsxref("Global_Objects/Error", "неуниверсальных ошибок", "#Error_types", 1)}} наследуются от Error.prototype. Как и со всеми функциями-конструкторами, вы можете использовать прототип конструктора для добавления свойств и методов ко всем экземплярам, создаваемым этим конструктором.

- -

Свойства

- -

Стандартные свойства

- -
-
Error.prototype.constructor
-
Определяет функцию, создающую прототип экземпляра ошибки.
-
{{jsxref("Error.prototype.message")}}
-
Сообщение ошибки.
-
{{jsxref("Error.prototype.name")}}
-
Название ошибки.
-
- -

Расширения вендоров

- -
{{non-standard_header}}
- -

Microsoft

- -
-
{{jsxref("Error.prototype.description")}}
-
Описание ошибки. Аналогично свойству {{jsxref("Error.prototype.message", "message")}}.
-
{{jsxref("Error.prototype.number")}}
-
Номер ошибки.
-
- -

Mozilla

- -
-
{{jsxref("Error.prototype.fileName")}}
-
Путь к файлу, в котором возникла эта ошибка.
-
{{jsxref("Error.prototype.lineNumber")}}
-
Номер строки в файле, в котором возникла эта ошибка.
-
{{jsxref("Error.prototype.columnNumber")}}
-
Номер колонки в строке, на которой возникла эта ошибка.
-
{{jsxref("Error.prototype.stack")}}
-
Стек вызовов.
-
- -

Методы

- -
-
{{jsxref("Error.prototype.toSource()")}} {{non-standard_inline}}
-
Возвращает строку, содержащую исходный код указанного объекта {{jsxref("Global_Objects/Error", "Error")}}; вы можете использовать это значение для создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.
-
{{jsxref("Error.prototype.toString()")}}
-
Возвращает строку, представляющую указанный объект. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.
-
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 1-е издание.СтандартИзначальное определение. Реализована в JavaScript 1.1.
{{SpecName('ES5.1', '#sec-15.11.3.1', 'Error')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-error.prototype', 'Error')}}{{Spec2('ES6')}} 
- -

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

- -
{{CompatibilityTable}}
- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/global_objects/evalerror/prototype/index.html b/files/ru/web/javascript/reference/global_objects/evalerror/prototype/index.html deleted file mode 100644 index e7de1a018e..0000000000 --- a/files/ru/web/javascript/reference/global_objects/evalerror/prototype/index.html +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: EvalError.prototype -slug: Web/JavaScript/Reference/Global_Objects/EvalError/prototype -tags: - - Error - - EvalError - - JavaScript - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/EvalError -translation_of_original: Web/JavaScript/Reference/Global_Objects/EvalError/prototype ---- -
{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}
- -

Сводка

-

Свойство EvalError.prototype представляет прототип конструктора объекта {{jsxref("EvalError")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Все экземпляры {{jsxref("EvalError")}} наследуются от объекта EvalError.prototype. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.

- -

Свойства

-
-
EvalError.prototype.constructor
-
Определяет функцию, создающую прототип экземпляра.
-
{{jsxref("Error.prototype.message", "EvalError.prototype.message")}}
-
Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("EvalError")}} должен предоставлять своё собственное свойство message, в SpiderMonkey он наследует свойство {{jsxref("Error.prototype.message")}}.
-
{{jsxref("Error.prototype.name", "EvalError.prototype.name")}}
-
Название ошибки. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.fileName", "EvalError.prototype.fileName")}}
-
Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.lineNumber", "EvalError.prototype.lineNumber")}}
-
Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.columnNumber", "EvalError.prototype.columnNumber")}}
-
Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.stack", "EvalError.prototype.stack")}}
-
Стек вызовов. Унаследовано от {{jsxref("Error")}}.
-
- -

Методы

-

Хотя объект прототипа {{jsxref("EvalError")}} не содержит собственных методов, экземпляры {{jsxref("EvalError")}} наследуют некоторые методы из цепочки прототипов.

- -

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

- - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 3-е издание.СтандартИзначальное определение.
{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}{{Spec2('ES5.1')}}Определено как NativeError.prototype.
{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}{{Spec2('ES6')}}Определено как NativeError.prototype.
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/function/prototype/index.html b/files/ru/web/javascript/reference/global_objects/function/prototype/index.html deleted file mode 100644 index acf9fc5c6e..0000000000 --- a/files/ru/web/javascript/reference/global_objects/function/prototype/index.html +++ /dev/null @@ -1,152 +0,0 @@ ---- -title: Function.prototype -slug: Web/JavaScript/Reference/Global_Objects/Function/prototype -tags: - - Function - - JavaScript - - Property - - Prototype - - Reference - - Référence(2) -translation_of: Web/JavaScript/Reference/Global_Objects/Function -translation_of_original: Web/JavaScript/Reference/Global_Objects/Function/prototype ---- -
{{JSRef("Global_Objects", "Function")}}
- -

Сводка

- -

Свойство Function.prototype представляет прототип объекта {{jsxref("Global_Objects/Function", "Function")}}.

- -

Описание

- -

Объекты {{jsxref("Global_Objects/Function", "Function")}} наследуются от Function.prototype. Объект Function.prototype не может быть изменён.

- -

Свойства

- -
-
{{jsxref("Function.arguments")}} {{deprecated_inline}}
-
Массив, соответствующий аргументам, переданным в функцию. Это устаревшее свойство {{jsxref("Global_Objects/Function", "Function")}}, используйте вместо него объект {{jsxref("Functions_and_function_scope/arguments", "arguments")}}, доступный внутри функции.
-
{{jsxref("Function.arity")}} {{obsolete_inline}}
-
Использовалось для определения количества аргументов, ожидаемых функцией, но было удалено. Вместо него используйте свойство {{jsxref("Function.length", "length")}}.
-
{{jsxref("Function.caller")}} {{non-standard_inline}}
-
Определяет функцию, вызвавшую текущую выполняющуюся функцию.
-
{{jsxref("Function.length")}}
-
Определяет количество аргументов, ожидаемых функцией.
-
{{jsxref("Function.name")}} {{non-standard_inline}}
-
Имя функции.
-
{{jsxref("Function.displayName")}} {{non-standard_inline}}
-
Отображаемое имя функции.
-
Function.prototype.constructor
-
Определяет функцию, создающую прототип объекта. Смотрите документацию по {{jsxref("Object.prototype.constructor")}}.
-
- -

Методы

- -
-
{{jsxref("Function.prototype.apply()")}}
-
Вызывает функцию и устанавливает this в контекст предоставленного значения; аргументы передаются объектом {{jsxref("Global_Objects/Array", "Array")}}.
-
{{jsxref("Function.prototype.bind()")}}
-
Создаёт новую функцию, которая, при вызове, самостоятельно вызывает эту функцию в контексте предоставленного значения, с данной последовательностью аргументов, предшествующих любым аргументам, переданным в новую функцию при её вызове. Устанавливает this в контекст предоставленного значения.
-
{{jsxref("Function.prototype.call()")}}
-
Вызывает (выполняет) функцию и устанавливает this в контекст предоставленного значения; аргументы передаются как есть.
-
{{jsxref("Function.prototype.isGenerator()")}} {{non-standard_inline}}
-
Возвращает true, если функция является генератором; в противном случае возвращает false.
-
{{jsxref("Function.prototype.toSource()")}} {{non-standard_inline}}
-
Возвращает строку, представляющую исходный код функции. Переопределяет метод {{jsxref("Object.prototype.toSource")}}.
-
{{jsxref("Function.prototype.toString()")}}
-
Возвращает строку, представляющую исходный код функции. Переопределяет метод {{jsxref("Object.prototype.toString")}}.
-
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
{{SpecName('ES1')}}{{Spec2('ES1')}}Изначальное определение. Реализована в JavaScript 1.1.
{{SpecName('ES5.1', '#sec-15.3.3.1', 'Function.prototype')}}
- Для экземпляров объекта {{jsxref("Global_Objects/Function", "Function")}}:
- {{SpecName('ES5.1', '#sec-15.3.5.2', 'Function.prototype')}}		{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-function.prototype', 'Function.prototype')}}
- Для экземпляров объекта {{jsxref("Global_Objects/Function", "Function")}}:
- {{SpecName('ES6', '#sec-function-instances-prototype', 'Function.prototype')}}		{{Spec2('ES6')}} 
{{SpecName('ESDraft', '#sec-function-instances-prototype', 'Function.prototype')}}{{Spec2('ESDraft')}} 
- -

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

- -
{{CompatibilityTable}}
- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/global_objects/generatorfunction/prototype/index.html b/files/ru/web/javascript/reference/global_objects/generatorfunction/prototype/index.html deleted file mode 100644 index b9974a46a3..0000000000 --- a/files/ru/web/javascript/reference/global_objects/generatorfunction/prototype/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: GeneratorFunction.prototype -slug: Web/JavaScript/Reference/Global_Objects/GeneratorFunction/prototype -translation_of: Web/JavaScript/Reference/Global_Objects/GeneratorFunction -translation_of_original: Web/JavaScript/Reference/Global_Objects/GeneratorFunction/prototype ---- -
{{JSRef}}
- -

Свойство GeneratorFunction.prototype представляет собой прототип объекта {{jsxref("GeneratorFunction")}} .

- -

Описание

- -

Объект {{jsxref("GeneratorFunction")}} наследуется из GeneratorFunction.prototype. GeneratorFunction.prototype не может быть изменён.

- -

Свойства

- -
-
GeneratorFunction.constructor
-
Изначальное значение {{jsxref("GeneratorFunction")}}.
-
GeneratorFunction.prototype.prototype
-
Значение %GeneratorPrototype%.
-
- -

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

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-generatorfunction.prototype', 'GeneratorFunction.prototype')}}{{Spec2('ES2015')}}Изначальное определение.
{{SpecName('ESDraft', '#sec-generatorfunction.prototype', 'GeneratorFunction.prototype')}}{{Spec2('ESDraft')}}
- -

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

- -
- - -

{{Compat("javascript.builtins.GeneratorFunction.prototype")}}

-
- -

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

- - diff --git a/files/ru/web/javascript/reference/global_objects/internalerror/prototype/index.html b/files/ru/web/javascript/reference/global_objects/internalerror/prototype/index.html deleted file mode 100644 index 633ffbf9fb..0000000000 --- a/files/ru/web/javascript/reference/global_objects/internalerror/prototype/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: InternalError.prototype -slug: Web/JavaScript/Reference/Global_Objects/InternalError/prototype -tags: - - Error - - InternalError - - JavaScript - - Non-standard - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/InternalError -translation_of_original: Web/JavaScript/Reference/Global_Objects/InternalError/prototype ---- -
{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}} {{non-standard_header}}
- -

Сводка

-

Свойство InternalError.prototype представляет прототип конструктора объекта {{jsxref("InternalError")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Все экземпляры {{jsxref("InternalError")}} наследуются от объекта InternalError.prototype. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.

- -

Свойства

-
-
InternalError.prototype.constructor
-
Определяет функцию, создающую прототип экземпляра.
-
{{jsxref("Error.prototype.message", "InternalError.prototype.message")}}
-
Сообщение ошибки. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.name", "InternalError.prototype.name")}}
-
Название ошибки. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.fileName", "InternalError.prototype.fileName")}}
-
Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.lineNumber", "InternalError.prototype.lineNumber")}}
-
Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.columnNumber", "InternalError.prototype.columnNumber")}}
-
Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.stack", "InternalError.prototype.stack")}}
-
Стек вызовов. Унаследовано от {{jsxref("Error")}}.
-
- -

Методы

-

Хотя объект прототипа {{jsxref("InternalError")}} не содержит собственных методов, экземпляры {{jsxref("InternalError")}} наследуют некоторые методы из цепочки прототипов.

- -

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

-

Не является частью какой-либо спецификации.

- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatNo}}{{CompatNo}}{{CompatVersionUnknown}}{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/intl/collator/prototype/index.html b/files/ru/web/javascript/reference/global_objects/intl/collator/prototype/index.html deleted file mode 100644 index eb708cca36..0000000000 --- a/files/ru/web/javascript/reference/global_objects/intl/collator/prototype/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Intl.Collator.prototype -slug: Web/JavaScript/Reference/Global_Objects/Intl/Collator/prototype -tags: - - Collator - - Internationalization - - JavaScript - - Property - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Collator -translation_of_original: Web/JavaScript/Reference/Global_Objects/Intl/Collator/prototype ---- -
{{JSRef("Global_Objects", "Collator", "Intl,DateTimeFormat,NumberFormat")}}
- -

Сводка

-

Свойство Intl.Collator.prototype представляет объект прототипа конструктора {{jsxref("Global_Objects/Collator", "Intl.Collator")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Смотрите {{jsxref("Global_Objects/Collator", "Collator")}} для описания экземпляров Intl.NumberFormat.

-

Экземпляры {{jsxref("Global_Objects/Collator", "Intl.Collator")}} наследуются от Intl.NumberFormat.prototype. Изменения объекта прототипа наследуются всеми экземплярами {{jsxref("Global_Objects/Collator", "Intl.Collator")}}.

- -

Свойства

-
-
Intl.Collator.prototype.constructor
-
Ссылка на {{jsxref("Global_Objects/Collator", "Intl.Collator")}}.
-
{{jsxref("Collator.compare", "Intl.Collator.prototype.compare")}}
-
Геттер; возвращает функцию, сравнивающую две строки согласно порядку сортировки этого объекта {{jsxref("Global_Objects/Collator", "Collator")}}.
-
- -

Методы

-
-
{{jsxref("Collator.resolvedOptions", "Intl.Collator.prototype.resolvedOptions()")}}
-
Возвращает новый объект со свойствами, отражающими локаль и опции сравнения строк, вычисленные при инициализации объекта.
-
- -

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

- - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
{{SpecName('ES Int 1.0', '#sec-10.2.1', 'Intl.Collator.prototype')}}{{Spec2('ES Int 1.0')}}Изначальное определение.
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Базовая поддержка{{CompatChrome("24")}}{{CompatGeckoDesktop("29")}}{{CompatIE("11")}}{{CompatOpera("15")}}{{CompatNo}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Базовая поддержка{{CompatNo}}{{CompatChrome("26")}} - {{CompatNo}}
- {{bug("864843")}} - 		{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/intl/datetimeformat/prototype/index.html b/files/ru/web/javascript/reference/global_objects/intl/datetimeformat/prototype/index.html deleted file mode 100644 index a22ec7aeaa..0000000000 --- a/files/ru/web/javascript/reference/global_objects/intl/datetimeformat/prototype/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Intl.DateTimeFormat.prototype -slug: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/prototype -tags: - - DateTimeFormat - - Internationalization - - JavaScript - - Property - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat -translation_of_original: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/prototype ---- -
{{JSRef("Global_Objects", "DateTimeFormat", "Intl,Collator,NumberFormat")}}
- -

Сводка

-

Свойство Intl.DateTimeFormat.prototype представляет объект прототипа конструктора {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Смотрите {{jsxref("Global_Objects/DateTimeFormat", "DateTimeFormat")}} для описания экземпляров Intl.NumberFormat.

-

Экземпляры {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}} наследуются от Intl.NumberFormat.prototype. Изменения объекта прототипа наследуются всеми экземплярами {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}.

- -

Свойства

-
-
Intl.DateTimeFormat.prototype.constructor
-
Ссылка на {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}.
-
{{jsxref("DateTimeFormat.format", "Intl.DateTimeFormat.prototype.format")}}
-
Геттер; возвращает функцию, форматирующую дату согласно локали и опциям форматирования этого объекта {{jsxref("Global_Objects/DateTimeFormat", "DateTimeFormat")}}.
-
- -

Методы

-
-
{{jsxref("DateTimeFormat.resolvedOptions", "Intl.DateTimeFormat.prototype.resolvedOptions()")}}
-
Возвращает новый объект со свойствами, отражающими локаль и опции форматирования, вычисленные при инициализации объекта.
-
- -

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

- - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
{{SpecName('ES Int 1.0', '#sec-12.2.1', 'Intl.DateTimeFormat.prototype')}}{{Spec2('ES Int 1.0')}}Изначальное определение.
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Базовая поддержка{{CompatChrome("24")}}{{CompatGeckoDesktop("29")}}{{CompatIE("11")}}{{CompatOpera("15")}}{{CompatNo}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Базовая поддержка{{CompatNo}}{{CompatChrome("26")}} - {{CompatNo}}
- {{bug("864843")}} - 		{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/intl/numberformat/prototype/index.html b/files/ru/web/javascript/reference/global_objects/intl/numberformat/prototype/index.html deleted file mode 100644 index fd9fbeeac8..0000000000 --- a/files/ru/web/javascript/reference/global_objects/intl/numberformat/prototype/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: Intl.NumberFormat.prototype -slug: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/prototype -tags: - - Internationalization - - JavaScript - - NumberFormat - - Property - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat -translation_of_original: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/prototype ---- -
{{JSRef("Global_Objects", "NumberFormat", "Intl,Collator,DateTimeFormat")}}
- -

Сводка

-

Свойство Intl.NumberFormat.prototype представляет объект прототипа конструктора {{jsxref("Global_Objects/NumberFormat", "Intl.NumberFormat")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Смотрите {{jsxref("NumberFormat")}} для описания экземпляров Intl.NumberFormat.

-

Экземпляры {{jsxref("Global_Objects/NumberFormat", "Intl.NumberFormat")}} наследуются от Intl.NumberFormat.prototype. Изменения объекта прототипа наследуются всеми экземплярами {{jsxref("Global_Objects/NumberFormat", "Intl.NumberFormat")}}.

- -

Свойства

-
-
Intl.NumberFormat.prototype.constructor
-
Ссылка на {{jsxref("Global_Objects/NumberFormat", "Intl.NumberFormat")}}.
-
{{jsxref("NumberFormat.format", "Intl.NumberFormat.prototype.format")}}
-
Геттер; возвращает функцию, форматирующую число согласно локали и опциям форматирования этого объекта {{jsxref("Global_Objects/NumberFormat", "NumberFormat")}}.
-
- -

Методы

-
-
{{jsxref("NumberFormat.resolvedOptions", "Intl.NumberFormat.prototype.resolvedOptions()")}}
-
Возвращает новый объект со свойствами, отражающими локаль и опции сравнения, вычисленные при инициализации объекта.
-
- -

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

- - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
{{SpecName('ES Int 1.0', '#sec-11.2.1', 'Intl.NumberFormat.prototype')}}{{Spec2('ES Int 1.0')}}Изначальное определение.
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
Базовая поддержка{{CompatChrome("24")}}{{CompatGeckoDesktop("29")}}{{CompatIE("11")}}{{CompatOpera("15")}}{{CompatNo}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
Базовая поддержка{{CompatNo}}{{CompatChrome("26")}} - {{CompatNo}}
- {{bug("864843")}} - 		{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/map/prototype/index.html b/files/ru/web/javascript/reference/global_objects/map/prototype/index.html deleted file mode 100644 index a3af6a0c61..0000000000 --- a/files/ru/web/javascript/reference/global_objects/map/prototype/index.html +++ /dev/null @@ -1,126 +0,0 @@ ---- -title: Map.prototype -slug: Web/JavaScript/Reference/Global_Objects/Map/prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map -translation_of_original: Web/JavaScript/Reference/Global_Objects/Map/prototype ---- -
{{JSRef}}
- -

Свойство Map.prototype представляет собой прототип конструктора {{jsxref("Map")}}.

- -
{{js_property_attributes(0,0,0)}}
- -

Описание

- -

Экземпляры {{jsxref("Map")}} наследуются от {{jsxref("Map.prototype")}}. Вы можете использовать объект конструктора прототипа для добавления свойств и методов ко всем экземплярам Map.

- -

Свойства

- -
-
Map.prototype.constructor
-
Возвращает функцию, создающую экземпляр прототипа. Это функция {{jsxref("Map")}} по умолчанию. 
-
{{jsxref("Map.prototype.size")}}
-
Возвращает количество пар key/value, содержащихся в объекте Map.
-
- -

Методы

- -
-
{{jsxref("Map.prototype.clear()")}}
-
Удаляет все пары key/value из объекта Map.
-
{{jsxref("Map.delete", "Map.prototype.delete(key)")}}
-
Возвращает true, если элемент присутствовал в объекте Map и был удалён, или false, если элемент отсутствует. После вызова этого метода Map.prototype.has(key) вернёт false.
-
{{jsxref("Map.prototype.entries()")}}
-
Возвращает новый объект итератора - new Iterator, который содержит массив из [key, value] для каждого элемента в объекте Map в порядке добавления.
-
{{jsxref("Map.forEach", "Map.prototype.forEach(callbackFn[, thisArg])")}}
-
Вызывает callbackFn для каждой пары key/value, находящейся в объекте Map, в порядке добавления. Если указан параметр thisArg, он будет использоваться в качестве значения this при каждом вызове callbackFn. 
-
{{jsxref("Map.get", "Map.prototype.get(key)")}}
-
Возвращает значение по указанному ключу key или undefined, если значение отсутствует. 
-
{{jsxref("Map.has", "Map.prototype.has(key)")}}
-
Возвращает true или false в зависимости от того, было ли значение связано с key в объекте Map или нет.
-
{{jsxref("Map.prototype.keys()")}}
-
Возвращает новый объект итератора - new Iterator, который содержит keys для каждого элемента в объекте Map в порядке добавления.
-
{{jsxref("Map.set", "Map.prototype.set(key, value)")}}
-
Устанавлиевает value для key в объекте Map. Возвращает объект Map.
-
{{jsxref("Map.prototype.values()")}}
-
Возвращает новый объект итератора - new Iterator, который содержит values для каждого элемента в объекте Map в порядке добавления.
-
{{jsxref("Map.@@iterator", "Map.prototype[@@iterator]()")}}
-
Возвращает новый объект итератора - new Iterator, который содержит массив из [key, value] для каждого элемента в объекте Map в порядке добавления. 
-
- -

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

- - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
{{SpecName('ES6', '#sec-map.prototype', 'Map.prototype')}}{{Spec2('ES6')}}Initial definition.
- -

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

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка38{{ CompatGeckoDesktop("13") }}11257.1
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatNo}}38{{CompatGeckoMobile("13")}}{{CompatNo}}{{CompatNo}} -

8

-
-
- -

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

- - diff --git "a/files/ru/web/javascript/reference/global_objects/math/\320\274\320\265\321\202\320\276\320\264_math.max()_/index.html" "b/files/ru/web/javascript/reference/global_objects/math/\320\274\320\265\321\202\320\276\320\264_math.max()_/index.html" deleted file mode 100644 index ab66d8acb0..0000000000 --- "a/files/ru/web/javascript/reference/global_objects/math/\320\274\320\265\321\202\320\276\320\264_math.max()_/index.html" +++ /dev/null @@ -1,136 +0,0 @@ ---- -title: Метод Math.max() -slug: Web/JavaScript/Reference/Global_Objects/Math/Метод_Math.max()_ -tags: - - JavaScript - - Math - - Method - - Reference ---- -
{{JSRef("Global_Objects", "Math")}}
- -
 
- -

Сводка

- -

Метод Math.max() возвращает наибольшее из нуля или более чисел.

- -

Синтаксис

- -
Math.max([value1[, value2[, ...]]])
- -

Параметры

- -
-
value1, value2, ...
-
Числа.
-
- -

Описание

- -

Поскольку метод max() является статическим методом объекта Math, вы всегда должны использовать его как Math.max(), а не пытаться вызывать метод на созданном экземпляре объекта Math (поскольку объект Math не является конструктором).

- -

При вызове без аргументов результатом вызова будет значение -{{jsxref("Global_Objects/Infinity", "Infinity")}}.

- -

Если хотя бы один из аргументов не может быть преобразован в число, результатом будет {{jsxref("Global_Objects/NaN", "NaN")}}.

- -

Примеры

- -

Пример: использование метода Math.max()

- -
Math.max(10, 20);   //  20
-Math.max(-10, -20); // -10
-Math.max(-10, 20);  //  20
-
- -

Следующая функция использует метод {{jsxref("Function.prototype.apply()")}} для нахождения максимального элемента в числовом массиве. Вызов getMaxOfArray([1, 2, 3]) эквивалентен вызову Math.max(1, 2, 3), однако вы можете использовать функцию getMaxOfArray() вместе с программно сконструированными массивами любого размера.

- -
function getMaxOfArray(numArray) {
-  return Math.max.apply(null, numArray);
-}
-
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 1-е издание.СтандартИзначальное определение. Реализована в JavaScript 1.0.
{{SpecName('ES5.1', '#sec-15.8.2.11', 'Math.max')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-math.max', 'Math.max')}}{{Spec2('ES6')}} 
- -

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

- -
{{CompatibilityTable}}
- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/global_objects/number/prototype/index.html b/files/ru/web/javascript/reference/global_objects/number/prototype/index.html deleted file mode 100644 index 259d8a3fb3..0000000000 --- a/files/ru/web/javascript/reference/global_objects/number/prototype/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: Number.prototype -slug: Web/JavaScript/Reference/Global_Objects/Number/prototype -tags: - - JavaScript - - Number - - Property - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Number -translation_of_original: Web/JavaScript/Reference/Global_Objects/Number/prototype ---- -
{{JSRef("Global_Objects", "Number")}}
- -

Сводка

-

Свойство Number.prototype представляет прототип конструктора {{jsxref("Global_Objects/Number", "Number")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Все экземпляры {{jsxref("Global_Objects/Number", "Number")}} наследуются от Number.prototype. Объект прототипа конструктора {{jsxref("Global_Objects/Number", "Number")}} может быть изменён для затрагивания всех экземпляров объекта {{jsxref("Global_Objects/Number", "Number")}}.

- -

Свойства

-
-
Number.prototype.constructor
-
Возвращает функцию, создавшую этот экземпляр объекта. По умолчанию ей является объект {{jsxref("Global_Objects/Number", "Number")}}.
-
- -
{{jsOverrides("Object", "properties", "constructor")}}
- -

Методы

-
-
{{jsxref("Number.prototype.toExponential()")}}
-
Возвращает строку, представляющую число в экспоненциальной записи.
-
{{jsxref("Number.prototype.toFixed()")}}
-
Возвращает строку, представляющую число в записи с фиксированной запятой.
-
{{jsxref("Number.prototype.toLocaleString()")}}
-
Возвращает строку с языко-зависимым представлением числа. Переопределяет метод {{jsxref("Object.prototype.toLocaleString()")}}.
-
{{jsxref("Number.prototype.toPrecision()")}}
-
Возвращает строку, представляющую число с указанной точностью в экспоненциальной записи, либо записи с фиксированной запятой.
-
{{jsxref("Number.prototype.toSource()")}} {{non-standard_inline}}
-
Возвращает объектный литерал, представляющий объект {{jsxref("Global_Objects/Number", "Number")}}; вы можете использовать это значение для создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.
-
{{jsxref("Number.prototype.toString()")}}
-
Возвращает строку, представляющую указанный объект по указанному основанию системы счисления. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.
-
{{jsxref("Number.prototype.valueOf()")}}
-
Возвращает примитивное значение указанного объекта. Переопределяет метод {{jsxref("Object.prototype.valueOf()")}}.
-
- -
{{jsOverrides("Object", "methods", "toExponential", "toFixed", "toLocaleString", "toPrecision", "toSource", "toString", "valueOf")}}
- -

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

- - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 1-е издание.СтандартИзначальное определение. Реализована в JavaScript 1.1.
{{SpecName('ES5.1', '#sec-15.7.4', 'Number')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-properties-of-the-number-prototype-object', 'Number')}}{{Spec2('ES6')}} 
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
diff --git a/files/ru/web/javascript/reference/global_objects/object/prototype/index.html b/files/ru/web/javascript/reference/global_objects/object/prototype/index.html deleted file mode 100644 index aaa398171d..0000000000 --- a/files/ru/web/javascript/reference/global_objects/object/prototype/index.html +++ /dev/null @@ -1,205 +0,0 @@ ---- -title: Object.prototype -slug: Web/JavaScript/Reference/Global_Objects/Object/prototype -tags: - - JavaScript - - Object - - Property - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Object -translation_of_original: Web/JavaScript/Reference/Global_Objects/Object/prototype ---- -
{{JSRef("Global_Objects", "Object")}}
- -

Сводка

- -

Свойство Object.prototype представляет объект прототипа {{jsxref("Global_Objects/Object", "Object")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

- -

Все объекты в JavaScript являются потомками {{jsxref("Global_Objects/Object", "Object")}}; все объекты наследуют методы и свойства из прототипа объекта Object.prototype, хотя они и могут быть переопределены (за исключением объекта Object с прототипом null, то есть, созданным вызовом Object.create(null)). Например, прототипы других конструкторов переопределяют свойство constructor и предоставляют свои собственные методы {{jsxref("Object.prototype.toString()", "toString()")}}. Изменения в объекте прототипа {{jsxref("Global_Objects/Object", "Object")}} распространяются на все объекты до тех пор, пока свойства и методы, учитывающие эти изменения, не переопределяются дальше по цепочке прототипов.

- -

Свойства

- -
-
{{jsxref("Object.prototype.constructor")}}
-
Определяет функцию, создающую прототип объекта.
-
{{jsxref("Object.proto", "Object.prototype.__proto__")}} {{non-standard_inline}}
-
Указывает на объект, который использовался в качестве прототипа при инстанцировании объекта.
-
{{jsxref("Object.noSuchMethod", "Object.prototype.__noSuchMethod__")}} {{non-standard_inline}}
-
Позволяет определить функцию, выполняющуюся при вызове в качестве метода неопределённого члена объекта.
-
{{jsxref("Object.count", "Object.prototype.__count__")}} {{obsolete_inline}}
-
Использовалось для возврата количества перечисляемых свойств, определённых напрямую на пользовательском объекте, но было удалено.
-
{{jsxref("Object.parent", "Object.prototype.__parent__")}} {{obsolete_inline}}
-
Использовалось для указания контекста объекта, но было удалено.
-
- -

Методы

- -
-
{{jsxref("Object.defineGetter", "Object.prototype.__defineGetter__()")}} {{non-standard_inline}} {{deprecated_inline}}
-
Ассоциирует функцию со свойством, которое, при доступе к нему, выполняет эту функцию и возвращает её возвращаемое значение.
-
{{jsxref("Object.defineSetter", "Object.prototype.__defineSetter__()")}} {{non-standard_inline}} {{deprecated_inline}}
-
Ассоциирует функцию со свойством, которое, при его установке, выполняет эту функцию, изменяющую свойство.
-
{{jsxref("Object.lookupGetter", "Object.prototype.__lookupGetter__()")}} {{non-standard_inline}} {{deprecated_inline}}
-
Возвращает функцию, ассоциированную с указанным свойством методом {{jsxref("Object.defineGetter", "__defineGetter__")}}.
-
{{jsxref("Object.lookupSetter", "Object.prototype.__lookupSetter__()")}} {{non-standard_inline}} {{deprecated_inline}}
-
Возвращает функцию, ассоциированную с указанным свойством методом {{jsxref("Object.defineSetter", "__defineSetter__")}}.
-
{{jsxref("Object.prototype.hasOwnProperty()")}}
-
Возвращает логическое значение, указывающее, содержит ли указанное свойство непосредственно объект, или он унаследовал его по цепочке прототипов.
-
{{jsxref("Object.prototype.isPrototypeOf()")}}
-
Возвращает логическое значение, указывающее, состоит ли указанный объект в цепочке прототипов объекта, на котором был вызван данный метод.
-
{{jsxref("Object.prototype.propertyIsEnumerable()")}}
-
Возвращает логическое значение, указывающее, установлен ли внутренний атрибут ECMAScript DontEnum.
-
{{jsxref("Object.prototype.toSource()")}} {{non-standard_inline}}
-
Возвращает строку, содержащую исходный код объекта в литеральной форме, представляющего объект, на котором был вызван данный метод; вы можете использовать это значение для создания нового объекта.
-
{{jsxref("Object.prototype.toLocaleString()")}}
-
Вызывает {{jsxref("Object.toString", "toString()")}}.
-
{{jsxref("Object.prototype.toString()")}}
-
Возвращает строковое представление объекта.
-
{{jsxref("Object.prototype.unwatch()")}} {{non-standard_inline}}
-
Удаляет точку наблюдения (watchpoint) со свойства объекта.
-
{{jsxref("Object.prototype.valueOf()")}}
-
Возвращает значение примитива указанного объекта.
-
{{jsxref("Object.prototype.watch()")}} {{non-standard_inline}}
-
Добавляет точку наблюдения (watchpoint) к свойству объекта.
-
{{jsxref("Object.prototype.eval()")}} {{obsolete_inline}}
-
Использовался для вычисления строки с JavaScript-кодом в контексте указанного объекта, но был удалён.
-
- -

Примеры

- -

Поскольку Javascript, строго говоря, не имеет объекты подклассов, прототип является полезным обходным путём создания объекта «базового класса» из определённых функций, которые выступают в роли объектов. Например:

- -
var Person = function(name) {
-    this.name = name;
-    this.canTalk = true;
-    this.greet = function() {
-        if (this.canTalk) {
-            console.log('Привет, я ' + this.name);
-        }
-    };
-};
-
-var Employee = function(name, title) {
-    this.name = name;
-    this.title = title;
-    this.greet = function() {
-        if (this.canTalk) {
-            console.log('Привет, я ' + this.name + ', ' + this.title);
-        }
-    };
-};
-Employee.prototype = new Person();
-
-var Customer = function(name) {
-    this.name = name;
-};
-Customer.prototype = new Person();
-
-var Mime = function(name) {
-    this.name = name;
-    this.canTalk = false;
-};
-Mime.prototype = new Person();
-
-var bob = new Employee('Боб', 'Строитель');
-var joe = new Customer('Джо');
-var rg = new Employee('Ред Грин', 'Разнорабочий');
-var mike = new Customer('Майк');
-var mime = new Mime('Мим');
-bob.greet();
-joe.greet();
-rg.greet();
-mike.greet();
-mime.greet();
-
- -

Вывод будет следующим:

- -
Привет, я Боб, Строитель
-Привет, я Джо
-Привет, я Ред Грин, Разнорабочий
-Привет, я Майк
-
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 1-е издание.СтандартИзначальное определение. Реализована в JavaScript 1.0.
{{SpecName('ES5.1', '#sec-15.2.3.1', 'Object.prototype')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-object.prototype', 'Object.prototype')}}{{Spec2('ES6')}}
- -

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

- -
{{CompatibilityTable}}
- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
diff --git a/files/ru/web/javascript/reference/global_objects/promise/prototype/index.html b/files/ru/web/javascript/reference/global_objects/promise/prototype/index.html deleted file mode 100644 index 65384e8346..0000000000 --- a/files/ru/web/javascript/reference/global_objects/promise/prototype/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: Promise.prototype -slug: Web/JavaScript/Reference/Global_Objects/Promise/prototype -tags: - - JavaScript - - Обещание - - Свойство -translation_of: Web/JavaScript/Reference/Global_Objects/Promise -translation_of_original: Web/JavaScript/Reference/Global_Objects/Promise/prototype ---- -
{{JSRef}}
- -

Cвойство Promise.prototype представляет собой прототип конструктора {{jsxref("Promise")}}.

- -
{{js_property_attributes(0,0,0)}}
- -

Описание

- -

{{jsxref("Promise")}} обьект наследованный от {{jsxref("Promise.prototype")}}. Вы можете использовать прототип конструктора  чтобы добавлять свойства или методы во все объекты обещаний.

- -

Свойства

- -
-
Promise.prototype.constructor
-
Возвращает функцию, которая создала прототип экземпляра. Это функция всех обещаний по умолчанию.
-
- -

Методы

- -
-
{{jsxref("Promise.catch", "Promise.prototype.catch(onRejected)")}}
-
Добавляет функцию обратного вызова для обработки отклонения обещания, которая возвращает новое обещание выполненное с переданным значением, если она вызвана, или оригинальное значение resolve, если обещание выполнено.
-
{{jsxref("Promise.then", "Promise.prototype.then(onFulfilled, onRejected)")}}
-
Добавляет обработчик выполнения и отклонения обещания, и возвращает новое обещание выполненное со значением вызванного обработчика, или оригинальное значение, если обещание не было обработано (т.е. если соответствующий обработчик onFulfilled или onRejected не является функцией).
-
- -

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

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES6', '#sec-promise.prototype', 'Promise.prototype')}}{{Spec2('ES6')}}Initial definition.
{{SpecName('ESDraft', '#sec-promise.prototype', 'Promise.prototype')}}{{Spec2('ESDraft')}}
- -

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

- - - -

Смотри также

- - diff --git a/files/ru/web/javascript/reference/global_objects/proxy/handler/deleteproperty/index.html b/files/ru/web/javascript/reference/global_objects/proxy/handler/deleteproperty/index.html deleted file mode 100644 index a796a08e26..0000000000 --- a/files/ru/web/javascript/reference/global_objects/proxy/handler/deleteproperty/index.html +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: handler.deleteProperty() -slug: Web/JavaScript/Reference/Global_Objects/Proxy/handler/deleteProperty -tags: - - Прокси - - метод -translation_of: Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/deleteProperty ---- -
{{JSRef}}
- -

Метод handler.deleteProperty() является "ловушкой" (функция-перехватчик) для оператора {{jsxref("Operators/delete", "delete")}}.

- -
{{EmbedInteractiveExample("pages/js/proxyhandler-deleteproperty.html", "taller")}}
- - - -

Синтаксис

- -
var p = new Proxy(target, {
-  deleteProperty: function(target, property) {
-  }
-});
-
- -

Параметры

- -

Следующие параметры передаются в метод deleteProperty.

- -
-
target
-
Целевой объект.
-
property
-
Имя или {{jsxref("Symbol")}} свойства, которое нужно удалить.
-
- -

this в момент вызова ссылается на объект handler.

- -

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

- -

Метод deleteProperty должен возвращать {{jsxref("Boolean")}}. Значение true, если свойство было успешно удалено, в противном случае false.

- -

Описание

- -

Метод handler.deleteProperty() является "ловушкой" для оператора {{jsxref("Operators/delete", "delete")}}.

- -

Перехваты

- -

Данная "ловушка" может перехватывать следующие операции:

- - - -

Инварианты

- -

Если следующие инварианты нарушены, то прокси выдаст ошибку {{jsxref("TypeError")}}:

- - - -

Примеры

- -

Следующий код перехватывает действие оператора {{jsxref("Operators/delete", "delete")}}.

- -
var p = new Proxy({}, {
-  deleteProperty: function(target, prop) {
-    if (prop in target){
-      delete target[prop]
-      console.log('property removed: ' + prop)
-      return true
-    }
-    else {
-      console.log('property not found: ' + prop)
-      return false
-    }
-  }
-})
-
-var result
-
-p.a = 10
-console.log('a' in p)  // true
-
-result = delete p.a    // "property removed: a"
-console.log(result)    // true
-console.log('a' in p)  // false
-
-result = delete p.a    // "property not found: a"
-console.log(result)    // false
-
- -

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

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-proxy-object-internal-methods-and-internal-slots-delete-p', '[[Delete]]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-proxy-object-internal-methods-and-internal-slots-delete-p', '[[Delete]]')}}{{Spec2('ESDraft')}} 
- -

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

- -
- - -

{{Compat("javascript.builtins.Proxy.handler.deleteProperty")}}

-
- -

Смотри также

- - diff --git a/files/ru/web/javascript/reference/global_objects/proxy/handler/index.html b/files/ru/web/javascript/reference/global_objects/proxy/handler/index.html deleted file mode 100644 index 472e9d4735..0000000000 --- a/files/ru/web/javascript/reference/global_objects/proxy/handler/index.html +++ /dev/null @@ -1,135 +0,0 @@ ---- -title: Proxy handler -slug: Web/JavaScript/Reference/Global_Objects/Proxy/handler -tags: - - ECMAScript 2015 - - JavaScript - - NeedsTranslation - - Proxy - - TopicStub - - Прокси - - Русский - - ловушки -translation_of: Web/JavaScript/Reference/Global_Objects/Proxy/Proxy -translation_of_original: Web/JavaScript/Reference/Global_Objects/Proxy/handler ---- -
{{JSRef}}
- -

Объект-обработчик прокси - это объект, который содержит ловушки для {{jsxref("Proxy", "proxies", "", 1)}}.

- -

Методы

- -

Все ловушки ставятся по желанию разработчика. Если ловушка не была определена, то, по умолчанию, операция перенаправляется на исходный объект (target).

- -
-
{{jsxref("Global_Objects/Proxy/handler/getPrototypeOf", "handler.getPrototypeOf()")}}
-
Ловушка для {{jsxref("Object.getPrototypeOf")}}.
-
{{jsxref("Global_Objects/Proxy/handler/setPrototypeOf", "handler.setPrototypeOf()")}}
-
Ловушка для {{jsxref("Object.setPrototypeOf")}}.
-
{{jsxref("Global_Objects/Proxy/handler/isExtensible", "handler.isExtensible()")}}
-
Ловушка для {{jsxref("Object.isExtensible")}}.
-
{{jsxref("Global_Objects/Proxy/handler/preventExtensions", "handler.preventExtensions()")}}
-
Ловушка для {{jsxref("Object.preventExtensions")}}.
-
{{jsxref("Global_Objects/Proxy/handler/getOwnPropertyDescriptor", "handler.getOwnPropertyDescriptor()")}}
-
Ловушка для {{jsxref("Object.getOwnPropertyDescriptor")}}.
-
{{jsxref("Global_Objects/Proxy/handler/defineProperty", "handler.defineProperty()")}}
-
Ловушка для {{jsxref("Object.defineProperty")}}.
-
{{jsxref("Global_Objects/Proxy/handler/has", "handler.has()")}}
-
Ловушка для оператора {{jsxref("Operators/in", "in")}}.
-
{{jsxref("Global_Objects/Proxy/handler/get", "handler.get()")}}
-
Ловушка для получения значений из свойств.
-
{{jsxref("Global_Objects/Proxy/handler/set", "handler.set()")}}
-
Ловушка для установки значений в свойства.
-
{{jsxref("Global_Objects/Proxy/handler/deleteProperty", "handler.deleteProperty()")}}
-
Ловушка для оператора {{jsxref("Operators/delete", "delete")}}.
-
{{jsxref("Global_Objects/Proxy/handler/ownKeys", "handler.ownKeys()")}}
-
Ловушка для {{jsxref("Object.getOwnPropertyNames")}} и {{jsxref("Object.getOwnPropertySymbols")}}.
-
{{jsxref("Global_Objects/Proxy/handler/apply", "handler.apply()")}}
-
Ловушка для вызова функции.
-
{{jsxref("Global_Objects/Proxy/handler/construct", "handler.construct()")}}
-
Ловушка для оператора {{jsxref("Operators/new", "new")}}.
-
- -

Некоторые нестандартные ловушки устарели и были удалены.

- -

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

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-proxy-object-internal-methods-and-internal-slots', 'Proxy Object Internal Methods and Internal Slots')}}{{Spec2('ES2015')}}Определении при инициализации.
{{SpecName('ESDraft', '#sec-proxy-object-internal-methods-and-internal-slots', 'Proxy Object Internal Methods and Internal Slots')}}{{Spec2('ESDraft')}}Обработчик enumerate был удален.
- -

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

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support49 [1]{{ CompatGeckoDesktop("18") }}12{{CompatOpera(36)}}{{CompatSafari(10)}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}{{CompatNo}}{{ CompatGeckoDesktop("18") }}{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
- -

[1] Разрешен по умолчанию.

- -

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

- - diff --git a/files/ru/web/javascript/reference/global_objects/proxy/handler/set/index.html b/files/ru/web/javascript/reference/global_objects/proxy/handler/set/index.html deleted file mode 100644 index 88b030ecc4..0000000000 --- a/files/ru/web/javascript/reference/global_objects/proxy/handler/set/index.html +++ /dev/null @@ -1,179 +0,0 @@ ---- -title: handler.set() -slug: Web/JavaScript/Reference/Global_Objects/Proxy/handler/set -tags: - - Прокси - - метод -translation_of: Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/set ---- -
{{JSRef}}
- -

Метод handler.set() является ловушкой для установки значения свойству.

- -

Синтаксис

- -
var p = new Proxy(target, {
-  set: function(target, property, value, receiver) {
-  }
-});
-
- -

Параметры

- -

Следующие параметры передаются методу set() . this привязан к обработчику

- -
-
target
-
Исходный обьект, который проксируется.
-
property
-
Имя свойства, в которое устанавливается значение value.
-
value
-
Значение, устанавливаемое в свойство property.
-
receiver
-
Объект, которому первоначально было присвоено задание. Обычно это сам прокси. Но обработчик set() также может быть вызван косвенно, через цепочку прототипов или различными другими способами.
-      Например, предположим, что скрипт выполняет obj.name = "jen", при этом obj не является прокси и не имеет собственного свойства .name, но имеет прокси в цепочке прототипов. Будет вызван обработчик прокси set() , а obj будет передан в качестве получателя.
-
-
- -

Возвращаемые результаты

- -

Метод set должен возвращать boolean значение.

- - - -

Описание

- -

Метод handler.set является ловушкой для установки значения свойству.

- -

Перехват

- -

Эта ловушка может перехватывать следующие операции:

- - - -

Инварианты

- -

Если нарушены следующие инваринаты, то proxy выбросит {{jsxref("TypeError")}}:

- - - -

Примеры

- -

Следующий код перехватывает установку значения свойству.

- -
var p = new Proxy({}, {
-  set: function(target, prop, value, receiver) {
-    target[prop] = value
-    console.log('property set: ' + prop + ' = ' + value)
-    return true
-  }
-})
-
-console.log('a' in p)  // false
-
-p.a = 10               // "property set: a = 10"
-console.log('a' in p)  // true
-console.log(p.a)       // 10
-
- -

Specifications

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-proxy-object-internal-methods-and-internal-slots-set-p-v-receiver', '[[Set]]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-proxy-object-internal-methods-and-internal-slots-set-p-v-receiver', '[[Set]]')}}{{Spec2('ESDraft')}}
- -

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

- -
{{CompatibilityTable}}
- -
- - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatChrome("61")}}{{CompatGeckoDesktop("18")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatSafari("10.1")}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("18")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/global_objects/proxy/proxy/deleteproperty/index.html b/files/ru/web/javascript/reference/global_objects/proxy/proxy/deleteproperty/index.html new file mode 100644 index 0000000000..a796a08e26 --- /dev/null +++ b/files/ru/web/javascript/reference/global_objects/proxy/proxy/deleteproperty/index.html @@ -0,0 +1,131 @@ +--- +title: handler.deleteProperty() +slug: Web/JavaScript/Reference/Global_Objects/Proxy/handler/deleteProperty +tags: + - Прокси + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/deleteProperty +--- +
{{JSRef}}
+ +

Метод handler.deleteProperty() является "ловушкой" (функция-перехватчик) для оператора {{jsxref("Operators/delete", "delete")}}.

+ +
{{EmbedInteractiveExample("pages/js/proxyhandler-deleteproperty.html", "taller")}}
+ + + +

Синтаксис

+ +
var p = new Proxy(target, {
+  deleteProperty: function(target, property) {
+  }
+});
+
+ +

Параметры

+ +

Следующие параметры передаются в метод deleteProperty.

+ +
+
target
+
Целевой объект.
+
property
+
Имя или {{jsxref("Symbol")}} свойства, которое нужно удалить.
+
+ +

this в момент вызова ссылается на объект handler.

+ +

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

+ +

Метод deleteProperty должен возвращать {{jsxref("Boolean")}}. Значение true, если свойство было успешно удалено, в противном случае false.

+ +

Описание

+ +

Метод handler.deleteProperty() является "ловушкой" для оператора {{jsxref("Operators/delete", "delete")}}.

+ +

Перехваты

+ +

Данная "ловушка" может перехватывать следующие операции:

+ + + +

Инварианты

+ +

Если следующие инварианты нарушены, то прокси выдаст ошибку {{jsxref("TypeError")}}:

+ + + +

Примеры

+ +

Следующий код перехватывает действие оператора {{jsxref("Operators/delete", "delete")}}.

+ +
var p = new Proxy({}, {
+  deleteProperty: function(target, prop) {
+    if (prop in target){
+      delete target[prop]
+      console.log('property removed: ' + prop)
+      return true
+    }
+    else {
+      console.log('property not found: ' + prop)
+      return false
+    }
+  }
+})
+
+var result
+
+p.a = 10
+console.log('a' in p)  // true
+
+result = delete p.a    // "property removed: a"
+console.log(result)    // true
+console.log('a' in p)  // false
+
+result = delete p.a    // "property not found: a"
+console.log(result)    // false
+
+ +

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

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES2015', '#sec-proxy-object-internal-methods-and-internal-slots-delete-p', '[[Delete]]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-proxy-object-internal-methods-and-internal-slots-delete-p', '[[Delete]]')}}{{Spec2('ESDraft')}} 
+ +

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

+ +
+ + +

{{Compat("javascript.builtins.Proxy.handler.deleteProperty")}}

+
+ +

Смотри также

+ + diff --git a/files/ru/web/javascript/reference/global_objects/proxy/proxy/set/index.html b/files/ru/web/javascript/reference/global_objects/proxy/proxy/set/index.html new file mode 100644 index 0000000000..88b030ecc4 --- /dev/null +++ b/files/ru/web/javascript/reference/global_objects/proxy/proxy/set/index.html @@ -0,0 +1,179 @@ +--- +title: handler.set() +slug: Web/JavaScript/Reference/Global_Objects/Proxy/handler/set +tags: + - Прокси + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/set +--- +
{{JSRef}}
+ +

Метод handler.set() является ловушкой для установки значения свойству.

+ +

Синтаксис

+ +
var p = new Proxy(target, {
+  set: function(target, property, value, receiver) {
+  }
+});
+
+ +

Параметры

+ +

Следующие параметры передаются методу set() . this привязан к обработчику

+ +
+
target
+
Исходный обьект, который проксируется.
+
property
+
Имя свойства, в которое устанавливается значение value.
+
value
+
Значение, устанавливаемое в свойство property.
+
receiver
+
Объект, которому первоначально было присвоено задание. Обычно это сам прокси. Но обработчик set() также может быть вызван косвенно, через цепочку прототипов или различными другими способами.
+      Например, предположим, что скрипт выполняет obj.name = "jen", при этом obj не является прокси и не имеет собственного свойства .name, но имеет прокси в цепочке прототипов. Будет вызван обработчик прокси set() , а obj будет передан в качестве получателя.
+
+
+ +

Возвращаемые результаты

+ +

Метод set должен возвращать boolean значение.

+ + + +

Описание

+ +

Метод handler.set является ловушкой для установки значения свойству.

+ +

Перехват

+ +

Эта ловушка может перехватывать следующие операции:

+ + + +

Инварианты

+ +

Если нарушены следующие инваринаты, то proxy выбросит {{jsxref("TypeError")}}:

+ + + +

Примеры

+ +

Следующий код перехватывает установку значения свойству.

+ +
var p = new Proxy({}, {
+  set: function(target, prop, value, receiver) {
+    target[prop] = value
+    console.log('property set: ' + prop + ' = ' + value)
+    return true
+  }
+})
+
+console.log('a' in p)  // false
+
+p.a = 10               // "property set: a = 10"
+console.log('a' in p)  // true
+console.log(p.a)       // 10
+
+ +

Specifications

+ + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-proxy-object-internal-methods-and-internal-slots-set-p-v-receiver', '[[Set]]')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-proxy-object-internal-methods-and-internal-slots-set-p-v-receiver', '[[Set]]')}}{{Spec2('ESDraft')}}
+ +

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

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatChrome("61")}}{{CompatGeckoDesktop("18")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatSafari("10.1")}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("18")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

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

+ + diff --git a/files/ru/web/javascript/reference/global_objects/rangeerror/prototype/index.html b/files/ru/web/javascript/reference/global_objects/rangeerror/prototype/index.html deleted file mode 100644 index 0e1df7fb7c..0000000000 --- a/files/ru/web/javascript/reference/global_objects/rangeerror/prototype/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: RangeError.prototype -slug: Web/JavaScript/Reference/Global_Objects/RangeError/prototype -tags: - - Error - - JavaScript - - Property - - Prototype - - RangeError -translation_of: Web/JavaScript/Reference/Global_Objects/RangeError -translation_of_original: Web/JavaScript/Reference/Global_Objects/RangeError/prototype ---- -
{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}
- -

Сводка

-

Свойство RangeError.prototype представляет прототип конструктора объекта {{jsxref("RangeError")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Все экземпляры {{jsxref("RangeError")}} наследуются от объекта RangeError.prototype. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.

- -

Свойства

-
-
RangeError.prototype.constructor
-
Определяет функцию, создающую прототип экземпляра.
-
{{jsxref("Error.prototype.message", "RangeError.prototype.message")}}
-
Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("RangeError")}} должен предоставлять своё собственное свойство message, в SpiderMonkey он наследует свойство {{jsxref("Error.prototype.message")}}.
-
{{jsxref("Error.prototype.name", "RangeError.prototype.name")}}
-
Название ошибки. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.fileName", "RangeError.prototype.fileName")}}
-
Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.lineNumber", "RangeError.prototype.lineNumber")}}
-
Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.columnNumber", "RangeError.prototype.columnNumber")}}
-
Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.stack", "RangeError.prototype.stack")}}
-
Стек вызовов. Унаследовано от {{jsxref("Error")}}.
-
- -

Методы

-

Хотя объект прототипа {{jsxref("RangeError")}} не содержит собственных методов, экземпляры {{jsxref("RangeError")}} наследуют некоторые методы из цепочки прототипов.

- -

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

- - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 3-е издание.СтандартИзначальное определение.
{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}{{Spec2('ES5.1')}}Определено как NativeError.prototype.
{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}{{Spec2('ES6')}}Определено как NativeError.prototype.
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/referenceerror/prototype/index.html b/files/ru/web/javascript/reference/global_objects/referenceerror/prototype/index.html deleted file mode 100644 index 1c73b6cb4e..0000000000 --- a/files/ru/web/javascript/reference/global_objects/referenceerror/prototype/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: ReferenceError.prototype -slug: Web/JavaScript/Reference/Global_Objects/ReferenceError/prototype -tags: - - Error - - JavaScript - - Property - - Prototype - - ReferenceError -translation_of: Web/JavaScript/Reference/Global_Objects/ReferenceError -translation_of_original: Web/JavaScript/Reference/Global_Objects/ReferenceError/prototype ---- -
{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}
- -

Сводка

-

Свойство ReferenceError.prototype представляет прототип конструктора объекта {{jsxref("ReferenceError")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Все экземпляры {{jsxref("ReferenceError")}} наследуются от объекта ReferenceError.prototype. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.

- -

Свойства

-
-
ReferenceError.prototype.constructor
-
Определяет функцию, создающую прототип экземпляра.
-
{{jsxref("Error.prototype.message", "ReferenceError.prototype.message")}}
-
Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("ReferenceError")}} должен предоставлять своё собственное свойство message, в SpiderMonkey он наследует свойство {{jsxref("Error.prototype.message")}}.
-
{{jsxref("Error.prototype.name", "ReferenceError.prototype.name")}}
-
Название ошибки. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.fileName", "ReferenceError.prototype.fileName")}}
-
Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.lineNumber", "ReferenceError.prototype.lineNumber")}}
-
Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.columnNumber", "ReferenceError.prototype.columnNumber")}}
-
Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.stack", "ReferenceError.prototype.stack")}}
-
Стек вызовов. Унаследовано от {{jsxref("Error")}}.
-
- -

Методы

-

Хотя объект прототипа {{jsxref("ReferenceError")}} не содержит собственных методов, экземпляры {{jsxref("ReferenceError")}} наследуют некоторые методы из цепочки прототипов.

- -

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

- - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 3-е издание.СтандартИзначальное определение.
{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}{{Spec2('ES5.1')}}Определено как NativeError.prototype.
{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}{{Spec2('ES6')}}Определено как NativeError.prototype.
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/regexp/prototype/index.html b/files/ru/web/javascript/reference/global_objects/regexp/prototype/index.html deleted file mode 100644 index b0a655760c..0000000000 --- a/files/ru/web/javascript/reference/global_objects/regexp/prototype/index.html +++ /dev/null @@ -1,141 +0,0 @@ ---- -title: RegExp.prototype -slug: Web/JavaScript/Reference/Global_Objects/RegExp/prototype -tags: - - JavaScript - - Property - - Prototype - - Reference - - RegExp - - регулярные выражения -translation_of: Web/JavaScript/Reference/Global_Objects/RegExp -translation_of_original: Web/JavaScript/Reference/Global_Objects/RegExp/prototype ---- -
{{JSRef("Global_Objects", "RegExp")}}
- -

Сводка

-

Свойство RegExp.prototype представляет объект прототипа для констуктора {{jsxref("Global_Objects/RegExp", "RegExp")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Описание экземпляров регулярных выражений смотрите на странице документации, посвящёной объекту {{jsxref("Global_Objects/RegExp", "RegExp")}}. Экземпляры регулярных выражений наследуются от RegExp.prototype. Изменение объекта прототипа распространяется на все экземпляры регулярных выражений.

- -

Свойства

-

Также смотрите устаревшие свойства объекта RegExp

-

Обратите внимание, что некоторые свойста объекта {{jsxref("Global_Objects/RegExp", "RegExp")}} имеют как длинные, так и короткие (Perl-подобные) имена. Оба имени всегда ссылаются на одно и тоже значение. Perl — это язык программирования, откуда JavaScript взял свои регулярные выражения.

-
-
RegExp.prototype.constructor
-
Определяет функцию, создающую прототип объекта.
-
{{jsxref("RegExp.prototype.global")}}
-
Определяет, надо ли проверять регулярное выражение на все возможные сопоставления со строкой, или достаточно только первый раз.
-
{{jsxref("RegExp.prototype.ignoreCase")}}
-
Определяет, надо ли игнорировать регистр символов при попытке сопоставления со строкой.
-
{{jsxref("RegExp.prototype.lastIndex")}}
-
Индекс, по которому начинается следующее сопоставление.
-
{{jsxref("RegExp.prototype.multiline")}}
-
Определяет, надо ли искать по нескольким строкам.
-
{{jsxref("RegExp.prototype.source")}}
-
Текст шаблона.
-
{{jsxref("RegExp.prototype.sticky")}} {{experimental_inline}}
-
Определяет, включён ли режим «липкого» поиска.
-
{{jsxref("RegExp.prototype.flags")}} {{experimental_inline}}
-
Строка, состоящая из флагов объекта регулярного выражения.
-
-
{{jsOverrides("Object", "properties", "constructor", "global", "ignoreCase", "lastIndex", "multiline", "source", "sticky")}}
- -

Методы

-

Также смотрите устаревшие методы объекта RegExp

-
-
{{jsxref("RegExp.prototype.exec()")}}
-
Выполняет поиск сопоставлений регулярного выражения в своём строковом параметре.
-
{{jsxref("RegExp.prototype.test()")}}
-
Пытается сопоставить регулярное выражение своему строковому параметру.
-
{{jsxref("RegExp.prototype.toSource()")}} {{non-standard_inline}}
-
Возвращает объектный литерал, представляющий указаный объект; вы можете использовать это значение для создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.
-
{{jsxref("RegExp.prototype.toString()")}}
-
Возвращает строку, представляющую указаннный объект. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.
-
-
{{jsOverrides("Object", "Methods", "exec", "test", "toSource", "toString")}}
- -

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

- - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 1-е издание.СтандартИзначальное определение. Реализована в JavaScript 1.1.
{{SpecName('ES5.1', '#sec-15.10.5.1', 'RegExp')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-regexp.prototype', 'RegExp.prototype')}}{{Spec2('ES6')}} 
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/set/prototype/index.html b/files/ru/web/javascript/reference/global_objects/set/prototype/index.html deleted file mode 100644 index a09b758046..0000000000 --- a/files/ru/web/javascript/reference/global_objects/set/prototype/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Set.prototype -slug: Web/JavaScript/Reference/Global_Objects/Set/prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Set -translation_of_original: Web/JavaScript/Reference/Global_Objects/Set/prototype ---- -
{{JSRef}}
- -

The Set.prototype property represents the prototype for the {{jsxref("Set")}} constructor.

- -
{{js_property_attributes(0,0,0)}}
- -

Description

- -

{{jsxref("Set")}} instances inherit from {{jsxref("Set.prototype")}}. You can use the constructor's prototype object to add properties or methods to all Set instances.

- -

Свойства

- -
-
Set.prototype.constructor
-
Возвращает функцию, которая создала прототип экземпляра. Это функция {{jsxref("Set")}} по умолчанию.
-
{{jsxref("Set.prototype.size")}}
-
Возвращает количество элементов в объекте Set.
-
- -

Методы

- -
-
{{jsxref("Set.add", "Set.prototype.add(value)")}}
-
Добавляет новый элемент с переданным значением в Set объект. Возвращает Set объект.
-
{{jsxref("Set.prototype.clear()")}}
-
Removes all elements from the Set object.
-
{{jsxref("Set.delete", "Set.prototype.delete(value)")}}
-
Removes the element associated to the value and returns the value that Set.prototype.has(value) would have previously returned. Set.prototype.has(value) will return false afterwards.
-
{{jsxref("Set.prototype.entries()")}}
-
Returns a new Iterator object that contains an array of [value, value] for each element in the Set object, in insertion order. This is kept similar to the Map object, so that each entry has the same value for its key and value here.
-
{{jsxref("Set.forEach", "Set.prototype.forEach(callbackFn[, thisArg])")}}
-
Calls callbackFn once for each value present in the Set object, in insertion order. If a thisArg parameter is provided to forEach, it will be used as the this value for each callback.
-
{{jsxref("Set.has", "Set.prototype.has(value)")}}
-
Returns a boolean asserting whether an element is present with the given value in the Set object or not.
-
{{jsxref("Set.prototype.keys()")}}
-
Is the same function as the values() function and returns a new Iterator object that contains the values for each element in the Set object in insertion order.
-
{{jsxref("Set.prototype.values()")}}
-
Returns a new Iterator object that contains the values for each element in the Set object in insertion order.
-
{{jsxref("Set.prototype.@@iterator()", "Set.prototype[@@iterator]()")}}
-
Returns a new Iterator object that contains the values for each element in the Set object in insertion order.
-
- -

Specifications

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-set.prototype', 'Set.prototype')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-set.prototype', 'Set.prototype')}}{{Spec2('ESDraft')}}
- -

Browser compatibility

- - - -

{{Compat("javascript.builtins.Set.prototype")}}

- -

See also

- - diff --git a/files/ru/web/javascript/reference/global_objects/string/prototype/index.html b/files/ru/web/javascript/reference/global_objects/string/prototype/index.html deleted file mode 100644 index 66537d9ae8..0000000000 --- a/files/ru/web/javascript/reference/global_objects/string/prototype/index.html +++ /dev/null @@ -1,230 +0,0 @@ ---- -title: String.prototype -slug: Web/JavaScript/Reference/Global_Objects/String/prototype -tags: - - JavaScript - - Property - - Prototype - - Reference - - String -translation_of: Web/JavaScript/Reference/Global_Objects/String -translation_of_original: Web/JavaScript/Reference/Global_Objects/String/prototype ---- -
{{JSRef("Global_Objects", "String")}}
- -

Сводка

- -

Свойство String.prototype представляет прототип объекта {{jsxref("Global_Objects/String", "String")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

- -

Все объекты {{jsxref("Global_Objects/String", "String")}} наследуются от String.prototype. Изменения в прототипе объекта {{jsxref("Global_Objects/String", "String")}} распространяются на все его экземпляры.

- -

Свойства

- -
-
String.prototype.constructor
-
Определяет функцию, создающую прототип этого объекта.
-
{{jsxref("String.prototype.length")}}
-
Отражает длину строки.
-
N
-
Используется для доступа к символу в позиции N, где N — это целое число между 0 и длиной строки {{jsxref("String.length", "length")}} минус один. Эти свойства доступны только для чтения.
-
- -

Методы

- -

Методы, не относящиеся к HTML

- -
-
{{jsxref("String.prototype.charAt()")}}
-
Возвращает символ по указанному индексу.
-
{{jsxref("String.prototype.charCodeAt()")}}
-
Возвращает число, представляющее значение символа в Юникоде по указанному индексу.
-
{{jsxref("String.prototype.codePointAt()")}} {{experimental_inline}}
-
Возвращает неотрицательное целое число, представляющее закодированную в UTF-16 кодовую точку значения по указанной позиции.
-
{{jsxref("String.prototype.concat()")}}
-
Объединяет текст двух строк и возвращает новую строку.
-
{{jsxref("String.prototype.includes()")}} {{experimental_inline}}
-
Определяет, находится ли строка внутри другой строки.
-
{{jsxref("String.prototype.endsWith()")}} {{experimental_inline}}
-
Определяет, заканчивается ли строка символами другой строки.
-
{{jsxref("String.prototype.indexOf()")}}
-
Возвращает индекс первого вхождения указанного значения в объекте {{jsxref("Global_Objects/String", "String")}}, на котором был вызван этот метод, или -1, если вхождений нет.
-
{{jsxref("String.prototype.lastIndexOf()")}}
-
Возвращает индекс последнего вхождения указанного значения в объекте {{jsxref("Global_Objects/String", "String")}}, на котором был вызван этот метод, или -1, если вхождений нет.
-
{{jsxref("String.prototype.localeCompare()")}}
-
Возвращает число, указывающее, находится ли образцовая строка до, после или на том же самом месте, что и указанная строка в порядке сортировки.
-
{{jsxref("String.prototype.match()")}}
-
Используется для сопоставления строке регулярного выражения.
-
- -
-
{{jsxref("String.prototype.matchAll()")}}
-
Возвращает итератор по всем результатам при сопоставлении строки с регулярным выражением.
-
- -
-
{{jsxref("String.prototype.normalize()")}} {{experimental_inline}}
-
Возвращает форму нормализации Юникода для строкового значения.
-
{{jsxref("String.prototype.quote()")}} {{obsolete_inline}}
-
Оборачивает строку в двойные кавычки (""").
-
{{jsxref("String.prototype.repeat()")}} {{experimental_inline}}
-
Возвращает строку. состоящую из элементов объекта, повторённых указанное количество раз.
-
{{jsxref("String.prototype.replace()")}}
-
Используется для сопоставления строке регулярного выражения и для замены совпавшей подстроки на новую подстроку.
-
{{jsxref("String.prototype.search()")}}
-
Выполняет поиск совпадения регулярного выражения со строкой.
-
{{jsxref("String.prototype.slice()")}}
-
Извлекает часть строки и возвращает новую строку.
-
{{jsxref("String.prototype.split()")}}
-
Разбивает объект {{jsxref("Global_Objects/String", "String")}} на массив строк, разделёных указанной строкой на подстроки.
-
{{jsxref("String.prototype.startsWith()")}} {{experimental_inline}}
-
Определяет, начинается ли строка символами другой строки.
-
{{jsxref("String.prototype.substr()")}}
-
Возвращает указанное количество символов в строке, начинающихся с указанной позиции.
-
{{jsxref("String.prototype.substring()")}}
-
Возвращает символы в строке между двумя индексами.
-
{{jsxref("String.prototype.toLocaleLowerCase()")}}
-
Приводит символы в строке к нижнему регистру согласно текущей локали. Для большинства языков, метод делает то же самое, что и метод {{jsxref("String.prototype.toLowerCase()", "toLowerCase()")}}.
-
{{jsxref("String.prototype.toLocaleUpperCase()")}}
-
Приводит символы в строке к верхнему регистру согласно текущей локали. Для большинства языков, метод делает то же самое, что и метод {{jsxref("String.prototype.toUpperCase()", "toUpperCase()")}}.
-
{{jsxref("String.prototype.toLowerCase()")}}
-
Возвращает строковое значение с символами в нижнем регистре.
-
{{jsxref("String.prototype.toSource()")}} {{non-standard_inline}}
-
Возвращает литерал объекта, представляющий указанный объект; вы можете использовать это значениедля создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.
-
{{jsxref("String.prototype.toString()")}}
-
Возвращает строковое представление указаного объекта. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.
-
{{jsxref("String.prototype.toUpperCase()")}}
-
Возвращает строковое значение с символами в верхнем регистре.
-
{{jsxref("String.prototype.trim()")}}
-
Обрезает пробельные символы в начале и в конце строки. Часть стандарта ECMAScript 5.
-
{{jsxref("String.prototype.trimLeft()")}} {{non-standard_inline}}
-
Обрезает пробельные символы с левой стороны строки.
-
{{jsxref("String.prototype.trimRight()")}} {{non-standard_inline}}
-
Обрезает пробельные символы с правой стороны строки.
-
{{jsxref("String.prototype.valueOf()")}}
-
Возвращает примитивное значение указанного объекта. Переопределяет метод {{jsxref("Object.prototype.valueOf()")}}.
-
{{jsxref("String.prototype.@@iterator()", "String.prototype[@@iterator]()")}} {{experimental_inline}}
-
Возвращает новый объект итератора Iterator, который итерируется по кодовым точкам строки и возвращает каждую кодовую точку в виде строкового значения.
-
- -

Методы-обёртки HTML

- -

Эти методы имеют ограниченное применение, поскольку они представляют только ограниченное подмножество доступных тегов и атрибутов HTML.

- -
-
{{jsxref("String.prototype.anchor()")}} {{deprecated_inline}}
-
<a name="имя"> (цель гипертекста)
-
{{jsxref("String.prototype.big()")}} {{deprecated_inline}}
-
{{HTMLElement("big")}}
-
{{jsxref("String.prototype.blink()")}} {{deprecated_inline}}
-
{{HTMLElement("blink")}}
-
{{jsxref("String.prototype.bold()")}} {{deprecated_inline}}
-
{{HTMLElement("b")}}
-
{{jsxref("String.prototype.fixed()")}} {{deprecated_inline}}
-
{{HTMLElement("tt")}}
-
{{jsxref("String.prototype.fontcolor()")}} {{deprecated_inline}}
-
<font color="цвет">
-
{{jsxref("String.prototype.fontsize()")}} {{deprecated_inline}}
-
<font size="размер">
-
{{jsxref("String.prototype.italics()")}} {{deprecated_inline}}
-
{{HTMLElement("i")}}
-
{{jsxref("String.prototype.link()")}} {{deprecated_inline}}
-
<a href="url"> (ссылка на URL)
-
{{jsxref("String.prototype.small()")}} {{deprecated_inline}}
-
{{HTMLElement("small")}}
-
{{jsxref("String.prototype.strike()")}} {{deprecated_inline}}
-
{{HTMLElement("strike")}}
-
{{jsxref("String.prototype.sub()")}} {{deprecated_inline}}}
-
{{HTMLElement("sub")}}
-
{{jsxref("String.prototype.sup()")}} {{deprecated_inline}}
-
{{HTMLElement("sup")}}
-
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 1-е издание.СтандартИзначальное определение.
{{SpecName('ES5.1', '#sec-15.5.3.1', 'String.prototype')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-string.prototype', 'String.prototype')}}{{Spec2('ES6')}}
- -

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

- -
{{CompatibilityTable}}
- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/global_objects/string/trimend/index.html b/files/ru/web/javascript/reference/global_objects/string/trimend/index.html new file mode 100644 index 0000000000..4a7bd8e907 --- /dev/null +++ b/files/ru/web/javascript/reference/global_objects/string/trimend/index.html @@ -0,0 +1,93 @@ +--- +title: String.prototype.trimRight() +slug: Web/JavaScript/Reference/Global_Objects/String/TrimRight +tags: + - JavaScript + - Method + - Non-standard + - Prototype + - Reference + - String +translation_of: Web/JavaScript/Reference/Global_Objects/String/trimEnd +--- +
{{JSRef("Global_Objects", "String")}} {{non-standard_header}}
+ +

Сводка

+

Метод trimRight() удаляет пробельные символы с правого конца строки.

+ +

Синтаксис

+
str.trimRight()
+ +

Описание

+

Метод trimRight() возвращает строку с вырезанными пробельными символами с её правого конца. Метод trimRight() не изменяет значение самой строки.

+ +

Примеры

+ +

Пример: использование метода trimRight()

+

Следующий пример покажет строку ' foo':

+
var str = '   foo  ';
+
+console.log(str.length); // 8
+
+str = str.trimRight();
+console.log(str.length); // 5
+console.log(str);        // '   foo'
+
+ +

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

+

Не является частью какого-либо стандарта. Реализована в JavaScript 1.8.1.

+ +

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

+
{{CompatibilityTable}}
+
+ + + + + + + + + + + + + + + + + + + +
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatGeckoDesktop("1.9.1")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+
+ + + + + + + + + + + + + + + + + + + + + +
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

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

+ diff --git a/files/ru/web/javascript/reference/global_objects/string/trimleft/index.html b/files/ru/web/javascript/reference/global_objects/string/trimleft/index.html deleted file mode 100644 index f60326e795..0000000000 --- a/files/ru/web/javascript/reference/global_objects/string/trimleft/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: String.prototype.trimLeft() -slug: Web/JavaScript/Reference/Global_Objects/String/TrimLeft -tags: - - JavaScript - - Method - - Non-standard - - Prototype - - Reference - - String -translation_of: Web/JavaScript/Reference/Global_Objects/String/trimStart ---- -
{{JSRef("Global_Objects", "String")}} {{non-standard_header}}
- -

Сводка

-

Метод trimLeft() удаляет пробельные символы с левого конца строки.

- -

Синтаксис

-
str.trimLeft()
- -

Описание

-

Метод trimLeft() возвращает строку с вырезанными пробельными символами с её левого конца. Метод trimLeft() не изменяет значение самой строки.

- -

Примеры

- -

Пример: использование метода trimLeft()

-

Следующий пример покажет строку 'foo ':

-
var str = '   foo  ';
-
-console.log(str.length); // 8
-
-str = str.trimLeft();
-console.log(str.length); // 5
-console.log(str);        // 'foo  '
-
- -

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

-

Не является частью какого-либо стандарта. Реализована в JavaScript 1.8.1.

- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatGeckoDesktop("1.9.1")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/string/trimright/index.html b/files/ru/web/javascript/reference/global_objects/string/trimright/index.html deleted file mode 100644 index 4a7bd8e907..0000000000 --- a/files/ru/web/javascript/reference/global_objects/string/trimright/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: String.prototype.trimRight() -slug: Web/JavaScript/Reference/Global_Objects/String/TrimRight -tags: - - JavaScript - - Method - - Non-standard - - Prototype - - Reference - - String -translation_of: Web/JavaScript/Reference/Global_Objects/String/trimEnd ---- -
{{JSRef("Global_Objects", "String")}} {{non-standard_header}}
- -

Сводка

-

Метод trimRight() удаляет пробельные символы с правого конца строки.

- -

Синтаксис

-
str.trimRight()
- -

Описание

-

Метод trimRight() возвращает строку с вырезанными пробельными символами с её правого конца. Метод trimRight() не изменяет значение самой строки.

- -

Примеры

- -

Пример: использование метода trimRight()

-

Следующий пример покажет строку ' foo':

-
var str = '   foo  ';
-
-console.log(str.length); // 8
-
-str = str.trimRight();
-console.log(str.length); // 5
-console.log(str);        // '   foo'
-
- -

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

-

Не является частью какого-либо стандарта. Реализована в JavaScript 1.8.1.

- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatGeckoDesktop("1.9.1")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/string/trimstart/index.html b/files/ru/web/javascript/reference/global_objects/string/trimstart/index.html new file mode 100644 index 0000000000..f60326e795 --- /dev/null +++ b/files/ru/web/javascript/reference/global_objects/string/trimstart/index.html @@ -0,0 +1,93 @@ +--- +title: String.prototype.trimLeft() +slug: Web/JavaScript/Reference/Global_Objects/String/TrimLeft +tags: + - JavaScript + - Method + - Non-standard + - Prototype + - Reference + - String +translation_of: Web/JavaScript/Reference/Global_Objects/String/trimStart +--- +
{{JSRef("Global_Objects", "String")}} {{non-standard_header}}
+ +

Сводка

+

Метод trimLeft() удаляет пробельные символы с левого конца строки.

+ +

Синтаксис

+
str.trimLeft()
+ +

Описание

+

Метод trimLeft() возвращает строку с вырезанными пробельными символами с её левого конца. Метод trimLeft() не изменяет значение самой строки.

+ +

Примеры

+ +

Пример: использование метода trimLeft()

+

Следующий пример покажет строку 'foo ':

+
var str = '   foo  ';
+
+console.log(str.length); // 8
+
+str = str.trimLeft();
+console.log(str.length); // 5
+console.log(str);        // 'foo  '
+
+ +

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

+

Не является частью какого-либо стандарта. Реализована в JavaScript 1.8.1.

+ +

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

+
{{CompatibilityTable}}
+
+ + + + + + + + + + + + + + + + + + + +
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatGeckoDesktop("1.9.1")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+
+ + + + + + + + + + + + + + + + + + + + + +
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatUnknown}}{{CompatUnknown}}{{CompatVersionUnknown}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
+
+ +

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

+ diff --git a/files/ru/web/javascript/reference/global_objects/symbol/prototype/index.html b/files/ru/web/javascript/reference/global_objects/symbol/prototype/index.html deleted file mode 100644 index b9ce5254e6..0000000000 --- a/files/ru/web/javascript/reference/global_objects/symbol/prototype/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: Symbol.prototype -slug: Web/JavaScript/Reference/Global_Objects/Symbol/prototype -tags: - - ECMAScript6 - - JavaScript - - Свойство - - Символы -translation_of: Web/JavaScript/Reference/Global_Objects/Symbol -translation_of_original: Web/JavaScript/Reference/Global_Objects/Symbol/prototype ---- -
{{JSRef}}
- -

Свойство Symbol.prototype указывает на прототип конструктора {{jsxref("Symbol")}}.

- -
{{js_property_attributes(0,0,0)}}
- -

Описание

- -

Экземпляры типа {{jsxref("Symbol")}} наследуют {{jsxref("Symbol.prototype")}}. Вы можете использовать прототип конструктора, чтобы добавить свойства и методы ко всем экземплярам типа Symbol.

- -

Свойства

- -
-
Symbol.prototype.constructor
-
Указывает на функцию, создавшую прототип экземпляра. По умолчанию это функция {{jsxref("Symbol")}}.
-
- -

Методы

- -
-
{{jsxref("Symbol.prototype.toSource()")}} {{Non-standard_inline}}
-
Возвращает строку, содержащую исходный код объекта {{jsxref("Global_Objects/Symbol", "Symbol")}}. Перегружает метод {{jsxref("Object.prototype.toSource()")}}.
-
{{jsxref("Symbol.prototype.toString()")}}
-
Возвращает строку, содержащую описание символа. Перегружает метод {{jsxref("Object.prototype.toString()")}}.
-
{{jsxref("Symbol.prototype.valueOf()")}}
-
Возвращает примитивное значение объекта {{jsxref("Symbol")}}. Перегружает метод {{jsxref("Object.prototype.valueOf()")}}.
-
- -

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

- - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES6', '#sec-symbol.prototype', 'Symbol.prototype')}}{{Spec2('ES6')}}Изначальное определение.
- -

Поддержка браузерами

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{ CompatGeckoDesktop("36.0") }}{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{ CompatGeckoMobile("36.0") }}{{CompatNo}}{{CompatNo}}{{CompatNo}}
-
diff --git a/files/ru/web/javascript/reference/global_objects/syntaxerror/prototype/index.html b/files/ru/web/javascript/reference/global_objects/syntaxerror/prototype/index.html deleted file mode 100644 index 840ac61f2b..0000000000 --- a/files/ru/web/javascript/reference/global_objects/syntaxerror/prototype/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: SyntaxError.prototype -slug: Web/JavaScript/Reference/Global_Objects/SyntaxError/prototype -tags: - - Error - - JavaScript - - Property - - Prototype - - SyntaxError -translation_of: Web/JavaScript/Reference/Global_Objects/SyntaxError -translation_of_original: Web/JavaScript/Reference/Global_Objects/SyntaxError/prototype ---- -
{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}
- -

Сводка

-

Свойство SyntaxError.prototype представляет прототип конструктора объекта {{jsxref("SyntaxError")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Все экземпляры {{jsxref("SyntaxError")}} наследуются от объекта SyntaxError.prototype. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.

- -

Свойства

-
-
SyntaxError.prototype.constructor
-
Определяет функцию, создающую прототип экземпляра.
-
{{jsxref("Error.prototype.message", "SyntaxError.prototype.message")}}
-
Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("SyntaxError")}} должен предоставлять своё собственное свойство message, в SpiderMonkey он наследует свойство {{jsxref("Error.prototype.message")}}.
-
{{jsxref("Error.prototype.name", "SyntaxError.prototype.name")}}
-
Название ошибки. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.fileName", "SyntaxError.prototype.fileName")}}
-
Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.lineNumber", "SyntaxError.prototype.lineNumber")}}
-
Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.columnNumber", "SyntaxError.prototype.columnNumber")}}
-
Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.stack", "SyntaxError.prototype.stack")}}
-
Стек вызовов. Унаследовано от {{jsxref("Error")}}.
-
- -

Методы

-

Хотя объект прототипа {{jsxref("SyntaxError")}} не содержит собственных методов, экземпляры {{jsxref("SyntaxError")}} наследуют некоторые методы из цепочки прототипов.

- -

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

- - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 3-е издание.СтандартИзначальное определение.
{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}{{Spec2('ES5.1')}}Определено как NativeError.prototype.
{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}{{Spec2('ES6')}}Определено как NativeError.prototype.
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/typedarray/prototype/index.html b/files/ru/web/javascript/reference/global_objects/typedarray/prototype/index.html deleted file mode 100644 index 1b79a06ad9..0000000000 --- a/files/ru/web/javascript/reference/global_objects/typedarray/prototype/index.html +++ /dev/null @@ -1,129 +0,0 @@ ---- -title: TypedArray.prototype -slug: Web/JavaScript/Reference/Global_Objects/TypedArray/prototype -tags: - - TypedArray - - Типизированный массив -translation_of: Web/JavaScript/Reference/Global_Objects/TypedArray -translation_of_original: Web/JavaScript/Reference/Global_Objects/TypedArray/prototype ---- -
{{JSRef}}
- -

Свойство TypedArray.prototype является прототипом для {{jsxref("TypedArray")}}-конструкторов.

- -
{{js_property_attributes(0,0,0)}}
- -

Описание

- -

Экземпляры {{jsxref("TypedArray")}} наследуются от {{jsxref("TypedArray.prototype")}}. Вы можете использовать объект прототипа конструктора для добавления в свойств и методов во все экземпляры TypedArray, где TypedArray это один из типизированных массивов.

- -

Также смотрите описание TypedArray для детальной информации о наследниках.

- -

Свойства

- -
-
TypedArray.prototype.constructor
-
Возвращает функцию, которая создала прототип экземпляра. Это единственное, что для объектов типизированных массивов функционирует по умолчанию.
-
{{jsxref("TypedArray.prototype.buffer")}} {{readonlyInline}}
-
Возвращает {{jsxref("ArrayBuffer")}}, на который ссылается типизированный массив. Значение фиксировано с времени создания и доступно только для чтения.
-
{{jsxref("TypedArray.prototype.byteLength")}} {{readonlyInline}}
-
Возвращает длину (в байтах) типизированного массива (с начала {{jsxref("ArrayBuffer")}}). Значение фиксировано с времени создания и доступно только для чтения.
-
{{jsxref("TypedArray.prototype.byteOffset")}} {{readonlyInline}}
-
Возвращает смещение (в байтах) типизированного массива от его {{jsxref("ArrayBuffer")}}. Значение фиксировано с времени создания и доступно только для чтения.
-
{{jsxref("TypedArray.prototype.length")}} {{readonlyInline}}
-
Возвращает число элементов типизированного массива. Значение фиксировано с времени создания и доступно только для чтения.
-
- -

Методы

- -
-
{{jsxref("TypedArray.prototype.copyWithin()")}}
-
Копирует последовательность элементов массива внутри него. Подробнее {{jsxref("Array.prototype.copyWithin()")}}.
-
{{jsxref("TypedArray.prototype.entries()")}}
-
Возвращает новый объект итератора Array Iterator, содержащий пары ключ / значение для каждого индекса массива. Подробнее {{jsxref("Array.prototype.entries()")}}.
-
{{jsxref("TypedArray.prototype.every()")}}
-
Проверяет, удовлетворяют ли все элементы массива условию, заданному в передаваемой функции. Подробнее {{jsxref("Array.prototype.every()")}}.
-
{{jsxref("TypedArray.prototype.fill()")}}
-
Заполняет все элементы массива от начального индекта до конечного индекса указанным значением. Подробнее {{jsxref("Array.prototype.fill()")}}.
-
{{jsxref("TypedArray.prototype.filter()")}}
-
Создаёт новый массив с теми элементами текущего массива, с которыми фильтрующая функция вернёт true. Подробнее {{jsxref("Array.prototype.filter()")}}.
-
{{jsxref("TypedArray.prototype.find()")}}
-
Возвращает значение элемента массива, если элемент удовлетворяет условию проверяющей функции, иначе возвращается undefined. Подробнее {{jsxref("Array.prototype.find()")}}.
-
{{jsxref("TypedArray.prototype.findIndex()")}}
-
Возвращает индекс элемента массива, если элемент удовлетворяет условию проверяющей функции, иначе возвращается -1. Подробнее {{jsxref("Array.prototype.findIndex()")}}.
-
{{jsxref("TypedArray.prototype.forEach()")}}
-
Выполняет указанную функцию один раз для каждого элемента в массиве. Подробнее {{jsxref("Array.prototype.forEach()")}}.
-
{{jsxref("TypedArray.prototype.includes()")}} {{experimental_inline}}
-
Определяет, содержит ли массив определённый элемент, возвращая в зависимости от этого true или false. Подробнее {{jsxref("Array.prototype.includes()")}}.
-
{{jsxref("TypedArray.prototype.indexOf()")}}
-
Возвращает первый (меньший) индекс элемента, значение которого равно указанному значению или -1, если такого индекса нет. Подробнее {{jsxref("Array.prototype.indexOf()")}}.
-
{{jsxref("TypedArray.prototype.join()")}}
-
Объединяет все элементы массива в строку . Подробнее {{jsxref("Array.prototype.join()")}}.
-
{{jsxref("TypedArray.prototype.keys()")}}
-
Возвращает новый итератор массива Array Iterator, содержащий ключи каждого индекса в массиве. Подробнее {{jsxref("Array.prototype.keys()")}}.
-
{{jsxref("TypedArray.prototype.lastIndexOf()")}}
-
Возвращает последний (больший) индекс элемента, значение которого равно заданному значению или -1, если такого индекса нет. Подробнее {{jsxref("Array.prototype.lastIndexOf()")}}.
-
{{jsxref("TypedArray.prototype.map()")}}
-
Создаёт новый массив с результатом вызова указанной функции для каждого элемента массива. Подробнее {{jsxref("Array.prototype.map()")}}.
-
{{jsxref("TypedArray.prototype.move()")}} {{non-standard_inline}} {{unimplemented_inline}}
-
Ранний нестандартный вариант от {{jsxref("TypedArray.prototype.copyWithin()")}}.
-
{{jsxref("TypedArray.prototype.reduce()")}}
-
Применяет функцию к аккумулятору и каждому значению массива (слева-направо), сводя его к одному значению. Подробнее {{jsxref("Array.prototype.reduce()")}}.
-
{{jsxref("TypedArray.prototype.reduceRight()")}}
-
Применяет функцию к аккумулятору и каждому значению массива (справа-налево), сводя его к одному значению. Подробнее {{jsxref("Array.prototype.reduceRight()")}}.
-
{{jsxref("TypedArray.prototype.reverse()")}}
-
Обращает порядок следования элементов массива. Первый элемент массива становится последним, а последний — первым. Подробнее {{jsxref("Array.prototype.reverse()")}}.
-
{{jsxref("TypedArray.prototype.set()")}}
-
Сохраняет несколько значений в типизированном массиве, получая входные значения из указанного массива.
-
{{jsxref("TypedArray.prototype.slice()")}}
-
Возвращает часть массива в новый объект массива. Подробнее {{jsxref("Array.prototype.slice()")}}.
-
{{jsxref("TypedArray.prototype.some()")}}
-
Возвращает true, если хоть какой-нибудь элемент массива удовлетворяет условию, заданному в передаваемой функции. Подробнее {{jsxref("Array.prototype.some()")}}.
-
{{jsxref("TypedArray.prototype.sort()")}}
-
На месте сортирует элементы массива и возвращает отсортированный массив. Подробнее {{jsxref("Array.prototype.sort()")}}.
-
{{jsxref("TypedArray.prototype.subarray()")}}
-
Возвращает новый TypedArray-объект, начиная с указанного стартового и кончая указанным конечным индексом элемента массива.
-
{{jsxref("TypedArray.prototype.values()")}}
-
Возвращает новый объект итератора массива Array Iterator, содержащий значения для каждого индекса в массиве. Подробнее {{jsxref("Array.prototype.values()")}}.
-
{{jsxref("TypedArray.prototype.toLocaleString()")}}
-
Возвращает локализованное строковое представление элементов массива. Подробнее {{jsxref("Array.prototype.toLocaleString()")}}.
-
{{jsxref("TypedArray.prototype.toString()")}}
-
Возвращает строковое представление указанного массива и его элементов . Подробнее {{jsxref("Array.prototype.toString()")}}.
-
{{jsxref("TypedArray.prototype.@@iterator()", "TypedArray.prototype[@@iterator]()")}}
-
Возвращает новый объект итератора массива Array Iterator, содержащий значения для каждого индекса массива.
-
- -

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

- - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусОписание
{{SpecName('ES6', '#sec-properties-of-the-%typedarrayprototype%-object', 'TypedArray prototype')}}{{Spec2('ES6')}}Первоначальное определение
{{SpecName('ESDraft', '#sec-properties-of-the-%typedarrayprototype%-object', 'TypedArray prototype')}}{{Spec2('ESDraft')}} 
- -

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

- - - -

{{Compat("javascript.builtins.TypedArray.prototype")}}

- -

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

- - diff --git a/files/ru/web/javascript/reference/global_objects/typeerror/prototype/index.html b/files/ru/web/javascript/reference/global_objects/typeerror/prototype/index.html deleted file mode 100644 index 87a22a4a94..0000000000 --- a/files/ru/web/javascript/reference/global_objects/typeerror/prototype/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: TypeError.prototype -slug: Web/JavaScript/Reference/Global_Objects/TypeError/prototype -tags: - - Error - - JavaScript - - Property - - Prototype - - TypeError -translation_of: Web/JavaScript/Reference/Global_Objects/TypeError -translation_of_original: Web/JavaScript/Reference/Global_Objects/TypeError/prototype ---- -
{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}
- -

Сводка

-

Свойство TypeError.prototype представляет прототип конструктора объекта {{jsxref("TypeError")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Все экземпляры {{jsxref("TypeError")}} наследуются от объекта TypeError.prototype. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.

- -

Свойства

-
-
TypeError.prototype.constructor
-
Определяет функцию, создающую прототип экземпляра.
-
{{jsxref("Error.prototype.message", "TypeError.prototype.message")}}
-
Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("TypeError")}} должен предоставлять своё собственное свойство message, в SpiderMonkey он наследует свойство {{jsxref("Error.prototype.message")}}.
-
{{jsxref("Error.prototype.name", "TypeError.prototype.name")}}
-
Название ошибки. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.fileName", "TypeError.prototype.fileName")}}
-
Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.lineNumber", "TypeError.prototype.lineNumber")}}
-
Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.columnNumber", "TypeError.prototype.columnNumber")}}
-
Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.stack", "TypeError.prototype.stack")}}
-
Стек вызовов. Унаследовано от {{jsxref("Error")}}.
-
- -

Методы

-

Хотя объект прототипа {{jsxref("TypeError")}} не содержит собственных методов, экземпляры {{jsxref("TypeError")}} наследуют некоторые методы из цепочки прототипов.

- -

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

- - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 3-е издание.СтандартИзначальное определение.
{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}{{Spec2('ES5.1')}}Определено как NativeError.prototype.
{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}{{Spec2('ES6')}}Определено как NativeError.prototype.
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/urierror/prototype/index.html b/files/ru/web/javascript/reference/global_objects/urierror/prototype/index.html deleted file mode 100644 index 9998443521..0000000000 --- a/files/ru/web/javascript/reference/global_objects/urierror/prototype/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: URIError.prototype -slug: Web/JavaScript/Reference/Global_Objects/URIError/prototype -tags: - - Error - - JavaScript - - Property - - Prototype - - URIError -translation_of: Web/JavaScript/Reference/Global_Objects/URIError -translation_of_original: Web/JavaScript/Reference/Global_Objects/URIError/prototype ---- -
{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}
- -

Сводка

-

Свойство URIError.prototype представляет прототип конструктора объекта {{jsxref("URIError")}}.

- -
{{js_property_attributes(0, 0, 0)}}
- -

Описание

-

Все экземпляры {{jsxref("URIError")}} наследуются от объекта URIError.prototype. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.

- -

Свойства

-
-
URIError.prototype.constructor
-
Определяет функцию, создающую прототип экземпляра.
-
{{jsxref("Error.prototype.message", "URIError.prototype.message")}}
-
Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("URIError")}} должен предоставлять своё собственное свойство message, в SpiderMonkey он наследует свойство {{jsxref("Error.prototype.message")}}.
-
{{jsxref("Error.prototype.name", "URIError.prototype.name")}}
-
Название ошибки. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.fileName", "URIError.prototype.fileName")}}
-
Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.lineNumber", "URIError.prototype.lineNumber")}}
-
Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.columnNumber", "URIError.prototype.columnNumber")}}
-
Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.
-
{{jsxref("Error.prototype.stack", "URIError.prototype.stack")}}
-
Стек вызовов. Унаследовано от {{jsxref("Error")}}.
-
- -

Методы

-

Хотя объект прототипа {{jsxref("URIError")}} не содержит собственных методов, экземпляры {{jsxref("URIError")}} наследуют некоторые методы из цепочки прототипов.

- -

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

- - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарии
ECMAScript 3-е издание.СтандартИзначальное определение.
{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}{{Spec2('ES5.1')}}Определено как NativeError.prototype.
{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}{{Spec2('ES6')}}Определено как NativeError.prototype.
- -

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

-
{{CompatibilityTable}}
-
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
-
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- diff --git a/files/ru/web/javascript/reference/global_objects/weakmap/prototype/index.html b/files/ru/web/javascript/reference/global_objects/weakmap/prototype/index.html deleted file mode 100644 index 56e1cf2fd8..0000000000 --- a/files/ru/web/javascript/reference/global_objects/weakmap/prototype/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: WeakMap.prototype -slug: Web/JavaScript/Reference/Global_Objects/WeakMap/prototype -translation_of: Web/JavaScript/Reference/Global_Objects/WeakMap -translation_of_original: Web/JavaScript/Reference/Global_Objects/WeakMap/prototype ---- -
{{JSRef}}
- -

WeakMap.prototype свойство указыкает на прототип {{jsxref("WeakMap")}} конструктора.

- -
{{js_property_attributes(0,0,0)}}
- -

Описание

- -

{{jsxref("WeakMap")}} экзепляры унаследывают {{jsxref("WeakMap.prototype")}}. Вы можите использовать прототип конструктора объекта для добавления нових свойств и/или методов всем экзепляра класса WeakMap.

- -

WeakMap.prototype является простым объектом:

- -
Object.prototype.toString.call(WeakMap.prototype); // "[object Object]"
- -

Свойства

- -
-
WeakMap.prototype.constructor
-
Возвращает функцию, создавшую экземпляр. {{jsxref("WeakMap")}} function by default.
-
- -

Методы

- -
-
{{jsxref("WeakMap.delete", "WeakMap.prototype.delete(key)")}}
-
Удаление значение по ключу. WeakMap.prototype.has(key) вернет false после.
-
{{jsxref("WeakMap.get", "WeakMap.prototype.get(key)")}}
-
Возвращает значение по ключу, or undefined такового нет.
-
{{jsxref("WeakMap.has", "WeakMap.prototype.has(key)")}}
-
Вернет логическое значение, связанное с существованием ключа.
-
{{jsxref("WeakMap.set", "WeakMap.prototype.set(key, value)")}}
-
Устанавливает значение по ключу, после возвращает самого себя.
-
{{jsxref("WeakMap.prototype.clear()")}} {{obsolete_inline}}
-
Удаляет все ключи-значения из WeakMap объекта. Заметьте, что это возможно, только есть WeakMap-like объект имеет.clear() метод путем инкапсулирования WeakMap объекта, раннее неимевшего его (смотри пример на странице {{jsxref("WeakMap")}})
-
- -

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

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES2015', '#sec-weakmap.prototype', 'WeakMap.prototype')}}{{Spec2('ES2015')}}Initial definition.
{{SpecName('ESDraft', '#sec-weakmap.prototype', 'WeakMap.prototype')}}{{Spec2('ESDraft')}} 
- -

Совместимость

- - - -

{{Compat("javascript.builtins.WeakMap.prototype")}}

- -

Рекомендуем

- - diff --git a/files/ru/web/javascript/reference/global_objects/weakset/prototype/index.html b/files/ru/web/javascript/reference/global_objects/weakset/prototype/index.html deleted file mode 100644 index 00725e2331..0000000000 --- a/files/ru/web/javascript/reference/global_objects/weakset/prototype/index.html +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: WeakSet.prototype -slug: Web/JavaScript/Reference/Global_Objects/WeakSet/prototype -tags: - - ECMAScript6 - - JavaScript - - Property - - WeakSet -translation_of: Web/JavaScript/Reference/Global_Objects/WeakSet -translation_of_original: Web/JavaScript/Reference/Global_Objects/WeakSet/prototype ---- -
{{JSRef("Global_Objects", "WeakSet")}}
- -

Свойство WeakSet.prototype представляет прототип для конструктора {{jsxref("WeakSet")}}.

- -
{{js_property_attributes(0,0,0)}}
- -

Описание

- -

Экземпляры {{jsxref("WeakSet")}} наследуются от {{jsxref("WeakSet.prototype")}}. Вы можете изменять прототип конструктора объекта для применения изменений ко всем экземплярам класса WeakSet.

- -

WeakSet.prototype сам по себе является обычным объектом:

- -
Object.prototype.toString.call(WeakSet.prototype); // "[object Object]"
- -

Свойства

- -
-
WeakSet.prototype.constructor
-
Возвращает функцию, создающую экземпляр прототипа. По умолчанию, это функция {{jsxref("WeakSet")}}.
-
- -

Методы

- -
-
{{jsxref("WeakSet.add", "WeakSet.prototype.add(value)")}}
-
Добавляет объект value в WeakSet. 
-
{{jsxref("WeakSet.delete", "WeakSet.prototype.delete(value)")}}
-
Удаляет из WeakSet элемент value. После удаления вызов WeakSet.prototype.has(value) возвращает false. 
-
{{jsxref("WeakSet.has", "WeakSet.prototype.has(value)")}}
-
Определяет, содержит WeakSet объект value или нет, возвращая, соответственно, true или false. 
-
{{jsxref("WeakSet.prototype.clear()")}} {{obsolete_inline}}
-
Удаляет все элементы из объекта WeakSet.
-
- -

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

- - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ES6', '#sec-weakset.prototype', 'WeakSet.prototype')}}{{Spec2('ES6')}}Изначальное определение.
{{SpecName('ESDraft', '#sec-weakset.prototype', 'WeakSet.prototype')}}{{Spec2('ESDraft')}} 
- -

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

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - -
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support36{{ CompatGeckoDesktop(34) }}{{CompatNo}}23{{CompatNo}}
Ordinary object{{CompatUnknown}}{{CompatGeckoDesktop("40")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FeatureChrome for AndroidAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatNo}}{{CompatNo}}{{ CompatGeckoMobile(34) }}{{CompatNo}}{{CompatNo}}{{CompatNo}}
Ordinary object{{CompatUnknown}}{{CompatUnknown}}{{CompatGeckoMobile("40")}}{{CompatUnknown}}{{CompatUnknown}}{{CompatUnknown}}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/operators/arithmetic_operators/index.html b/files/ru/web/javascript/reference/operators/arithmetic_operators/index.html deleted file mode 100644 index f1091e3706..0000000000 --- a/files/ru/web/javascript/reference/operators/arithmetic_operators/index.html +++ /dev/null @@ -1,291 +0,0 @@ ---- -title: Арифметические операции -slug: Web/JavaScript/Reference/Operators/Arithmetic_Operators -tags: - - JavaScript - - Операторы -translation_of: Web/JavaScript/Reference/Operators -translation_of_original: Web/JavaScript/Reference/Operators/Arithmetic_Operators ---- -
-
{{jsSidebar("Operators")}}
-
- -

Арифметические операции принимают в качестве операндов числовые значения (это может быть и литерал и переменная) и возвращают результат в виде одного числового значения. Стандартными арифметическими операциями являются сложение (+), вычитание (-), умножение (*) и деление (/).

- -

Сложение (+)

- -

Оператор сложения возвращает сумму числовых операндов или объединяет строки.

- -

Синтаксис

- -
Operator: x + y
-
- -

Примеры

- -
// Number + Number -> сложение
-1 + 2 // 3
-
-// Boolean + Number -> сложение
-true + 1 // 2
-
-// Boolean + Boolean -> сложение
-false + false // 0
-
-// Number + String -> конкатенация
-5 + "foo" // "5foo"
-
-// String + Boolean -> конкатенация
-"foo" + false // "foofalse"
-
-// String + String -> конкатенация
-"foo" + "bar" // "foobar"
-
- -

Вычитание (-)

- -

Оператор вычитания вычитает один операнд из другого и возвращает разницу.

- -

Синтаксис

- -
Operator: x - y
-
- -

Примеры

- -
5 - 3 // 2
-3 - 5 // -2
-"foo" - 3 // NaN
- -

Деление (/)

- -

Оператор деления производит деление его операндов, где левый операнд - делимый, а правый - делитель.

- -

Синтаксис

- -
Operator: x / y
-
- -

Примеры

- -
1 / 2      // возвращает 0.5 в JavaScript
-1 / 2      // возвращает 0 в Java
-// (так числа не с плавающими точками)
-
-1.0 / 2.0  // возвращает 0.5 и в JavaScript и в Java
-
-2.0 / 0    // возвращает Infinity в JavaScript
-2.0 / 0.0  // тоже возвращает Infinity
-2.0 / -0.0 // возвращает -Infinity в JavaScript
- -

Умножение (*)

- -

Оператор умножения возвращает произведение операндов.

- -

Синтаксис

- -
Operator: x * y
-
- -

Примеры

- -
2 * 2 // 4
--2 * 2 // -4
-Infinity * 0 // NaN
-Infinity * Infinity // Infinity
-"foo" * 2 // NaN
-
- -

Остаток от деления (%)

- -

Оператор возвращает целый остаток от деления левого операнда на правый. Возвращаемое значение всегда получает знак делимого, а не делителя.  Он использует встроенную функцию modulo, для получения результата, которая является целочисленным остатком деления var1 на var2 — например— var1 modulo var2. Есть предложение добавить оператор modulo в будущие версии ECMAScript, с той разницей, что оператор будет брать знак делителя, а не делимого.

- -

Синтаксис

- -
Оператор: var1 % var2
-
- -

Примеры

- -
12 % 5 // 2
--1 % 2 // -1
-NaN % 2 // NaN
-1 % 2 // 1
-2 % 3 // 2
--4 % 2 // -0
-5.5 % 2 // 1.5
- -

Возведение в степень (**)

- -

Оператор возведения в степень возвращает результат первого операнда в степень. это, var1var2, в предыдущем выражении, где var1 и var2 - переменные. Он право ассоциативен. a ** b ** c равно a ** (b ** c).

- -

Синтаксис

- -
Оператор: var1 ** var2
- -

Замечания

- -

Во многих языках, таких как PHP и Python и других, есть оператор возведения возведения в степень (обычно ^ или **), оператор определён имеющим приоритет выше, чем у унарных операторов, таких как унарный + и унарный -, но есть несколько исключений. Например, в Bash оператор ** создан имеющим приоритет ниже, чем у унарных операторов. В JavaScript невозможно написать двухсмысленное выражение, т.е. вы не можете ставить унарный оператор (+/-/~/!/delete/void/typeof) непосредственно перед базовым числом.

- -
-2 ** 2;
-// 4 в Bash, -4 в других языках.
-// Это некорректно в JavaScript, т.е. операция двухсмыслена.
-
-
--(2 ** 2);
-// -4 в JavaScript, намерения автора однозначны.
- -

Примеры

- -
2 ** 3 // 8
-3 ** 2 // 9
-3 ** 2.5 // 15.588457268119896
-10 ** -1 // 0.1
-NaN ** 2 // NaN
-
-2 ** 3 ** 2 // 512
-2 ** (3 ** 2) // 512
-(2 ** 3) ** 2 // 64
- -

Изменим знак результата возведения в степень:

- -
-(2 ** 2) // -4
- -

Насильная установка основания как отрицательного числа:

- -
(-2) ** 2 // 4
- -

Инкремент (++)

- -

Оператор инкремента увеличивает на единицу(инкрементирует) операнд и возвращает значение.

- - - -

Синтаксис

- -
Оператор: x++ или ++x
-
- -

Примеры

- -
// Постфиксный
-var x = 3;
-y = x++; // y = 3, x = 4
-
-// Префиксный
-var a = 2;
-b = ++a; // a = 3, b = 3
-
- -

- -

Декремент (--)

- -

Операция декремента уменьшает на 1 (отнимает единицу) свой операнд и возвращает значение.

- - - -

Синтаксис

- -
Оператор: x-- или --x
-
- -

Примеры

- -
// Постфиксный
-var x = 3;
-y = x--; // y = 3, x = 2
-
-// Префиксный
-var a = 2;
-b = --a; // a = 1, b = 1
-
- -

Унарный минус (-)

- -

Унарный минус ставится перед своим операндом и возвращает его математическое отрицание.

- -

Синтаксис

- -
Оператор: -x
-
- -

Примеры

- -
var x = 3;
-y = -x; // y = -3, x = 3
-
- -

Унарный плюс (+)

- -

Оператор унарный плюс предшедствует своему операнду и оценивает его, пытается преобразовать его в число, если он им не является. Хотя, унарное отрицание (-) также конвертирует не числа, унарный плюс - быстрейший и предпочитаемый способ конвертирования чего-либо в число потому, что он не выполняет каких-либо операций с числом. Он может конвертировать строковые представления целых и чисел с плавающей точкой, а также нестроковые значения true, false и null. Поддерживаются числа в десятичном и шестнадцатиричном (с префиксом "0x") формате. Отрицательные числа тоже поддерживаются (но не 16-ричные). Если он не может вычислить конкретное значение, выполнится как NaN.

- -

Синтаксис

- -
Оператор: +x
-
- -

Примеры

- -
+3     // 3
-+"3"   // 3
-+true  // 1
-+false // 0
-+null  // 0
-
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусПримечание
{{SpecName('ES1')}}{{Spec2('ES1')}}Изначальное определение
{{SpecName('ES5.1', '#sec-11.3')}}{{Spec2('ES5.1')}}Определено в нескольких секциях специфии: Additive operators, Multiplicative operators, Postfix expressions, Unary operators.
{{SpecName('ES6', '#sec-postfix-expressions')}}{{Spec2('ES6')}}Определено в нескольких секциях специфии: Additive operators, Multiplicative operators, Postfix expressions, Unary operators.
{{SpecName('ES7', '#sec-postfix-expressions')}}{{Spec2('ES7')}}Добавлен Оператор возведения в степень.
{{SpecName('ESDraft', '#sec-postfix-expressions')}}{{Spec2('ESDraft')}}
- -

Поддержка браузерами

- - - -

{{Compat("javascript.operators.arithmetic")}}

- -

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

- - diff --git a/files/ru/web/javascript/reference/operators/assignment/index.html b/files/ru/web/javascript/reference/operators/assignment/index.html new file mode 100644 index 0000000000..0517dc2ccd --- /dev/null +++ b/files/ru/web/javascript/reference/operators/assignment/index.html @@ -0,0 +1,66 @@ +--- +title: Присваивание (=) +slug: Web/JavaScript/Reference/Operators/Присваивание +tags: + - Assignment operator + - JavaScript + - Language feature + - Operator + - Reference + - Оператор + - Оператор присваивания + - "Особенность\_языка" + - справочник +translation_of: Web/JavaScript/Reference/Operators/Assignment +--- +
{{jsSidebar("Operators")}}
+ +

Простой оператор присваивания (=) используется для присваивания значения переменной. Операция присваивания вычисляется в присваиваемую величину. Присваивание по цепочке (chaining) используется для назначения нескольким переменным одинакового значения.

+ +

{{EmbedInteractiveExample("pages/js/expressions-assignment.html")}}

+ +
+ + + +

Синтаксис

+ +
Оператор: x = y
+
+ +

Примеры

+ +

Простое и цепное присваивание

+ +
// Предположим следующие переменные и их значения
+//  x = 5
+//  y = 10
+//  z = 25
+
+x = y     // x будет присвоено значение 10
+x = y = z // x, y и z будут равны 25
+ +

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

+ + + + + + + + + + +
Specification
{{SpecName('ESDraft', '#sec-assignment-operators', 'Assignment operators')}}
+ +

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

+ + + +

{{Compat("javascript.operators.assignment")}}

+ +

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

+ + diff --git a/files/ru/web/javascript/reference/operators/assignment_operators/index.html b/files/ru/web/javascript/reference/operators/assignment_operators/index.html deleted file mode 100644 index 5399324df0..0000000000 --- a/files/ru/web/javascript/reference/operators/assignment_operators/index.html +++ /dev/null @@ -1,431 +0,0 @@ ---- -title: Операторы присваивания -slug: Web/JavaScript/Reference/Operators/Assignment_Operators -tags: - - JavaScript - - Оператор -translation_of: Web/JavaScript/Reference/Operators#Assignment_operators -translation_of_original: Web/JavaScript/Reference/Operators/Assignment_Operators ---- -
{{jsSidebar("Operators")}}
- -

Оператор присваивания присваивает левому операнду значение, основанное на значении правого операнда.

- -

Описание

- -

Основной оператор присваивания - это знак равно (=), он и присваивает значение правого операнда, левому. То есть - x = y присваивает значение переменной y, переменной x. Другие операторы присваивания, как следует из приведенной ниже таблицы с определениями и примерами, являются сокращениями стандартных операций.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ИмяСокращенный операторСмысл
Присваиваниеx = yx = y
Присваивание со сложениемx += yx = x + y
Присваивание с вычитаниемx -= yx = x - y
Присваивание с умножениемx *= yx = x * y
Присваивание с делениемx /= yx = x / y
Присваивание по модулюx %= yx = x % y
Присваивание с левым сдвигомx <<= yx = x << y
Присваивание с правым сдвигомx >>= yx = x >> y
Присваивание с беззнаковым сдвигом вправоx >>>= yx = x >>> y
Присваивание с побитовым ANDx &= yx = x & y
Присваивание с побитовым XORx ^= yx = x ^ y
Присваивание с побитовым ORx |= yx = x | y
- -

Присваивание

- -

Простой оператор присваивания, который задает значение переменной. Цепочка операторов присваивания может быть использована для назначения нескольким переменным одного и того же значения. Смотрите пример.

- -

Синтаксис

- -
Оператор: x = y
-
- -

Примеры

- -
// Например, следующие переменные:
-//  x = 5
-//  y = 10
-//  z = 25
-
-x = y     // x - 10
-x = y = z // x, y и z все равны 25
-
- -

Присваивание со сложением

- -

Оператор добавочного присваивания, добавляет значение правого операнда к значению левого, и сохраняет результат в переменную левого операнда. Типы значений обоих операндов, определяют поведение оператора добавочного присваивания. Возможны сложение и конкатенация. Смотрите {{jsxref("Operators/Arithmetic_Operators", "addition operator", "#Addition", 1)}} для подробностей.

- -

Синтаксис

- -
Оператор: x += y
-Значение: x = x + y
-
- -

Примеры

- -
// Например, следующие переменные:
-//  foo = "foo"
-//  bar = 5
-//  baz = true
-
-// Результат исполнения каждого нижеприведенного примера
-// представлен в изоляции от предыдущих примеров (как если
-// бы значения переменных foo, bar, baz возвращались на
-// первоначальные)
-
-// Number + Number -> сложение
-bar += 2 // 7
-
-// Boolean + Number -> сложение
-baz += 1 // 2
-
-// Boolean + Boolean -> сложение
-baz += false // 1
-
-// Number + String -> конкатенация
-bar += "foo" // "5foo"
-
-// String + Boolean -> конкатенация
-foo += false // "foofalse"
-
-// String + String -> конкатенация
-foo += "bar" // "foobar"
-
- -

Присваивание с вычитанием

- -

Оператор вычитаемого присваивания вычитает значение правого операнда из значения левого, и присваивает результат переменной левого операнда. Смотрите {{jsxref("Operators/Arithmetic_Operators", "subtraction operator", "#Subtraction", 1)}} для подробностей.

- -

Синтаксис

- -
Оператор: x -= y
-Значение:  x  = x - y
-
- -

Примеры

- -
// Например, следующие переменные:
-//  bar = 5
-
-bar -= 2     // 3
-bar -= "foo" // NaN
-
- -

Присваивание с умножением

- -

The multiplication assignment operator multiplies a variable by the value of the right operand and assigns the result to the variable. See the {{jsxref("Operators/Arithmetic_Operators", "multiplication operator", "#Multiplication", 1)}} for more details.

- -

Синтаксис

- -
Оператор: x *= y
-Значение:  x  = x * y
-
- -

Примеры

- -
// Assuming the following variable
-//  bar = 5
-
-bar *= 2     // 10
-bar *= "foo" // NaN
-
- -

Присваивание с делением

- -

The division assignment operator divides a variable by the value of the right operand and assigns the result to the variable. See the {{jsxref("Operators/Arithmetic_Operators", "division operator", "#Division", 1)}} for more details.

- -

Синтаксис

- -
Оператор: x /= y
-Значение:  x  = x / y
-
- -

Примеры

- -
// Assuming the following variable
-//  bar = 5
-
-bar /= 2     // 2.5
-bar /= "foo" // NaN
-bar /= 0     // Infinity
-
- -

Присваивание по модулю

- -

The remainder assignment operator divides a variable by the value of the right operand and assigns the remainder to the variable. See the {{jsxref("Operators/Arithmetic_Operators", "remainder operator", "#Remainder", 1)}} for more details.

- -

Синтаксис

- -
Оператор: x %= y
-Значение:  x  = x % y
-
- -

Примеры

- -
// Assuming the following variable
-// bar = 5
-
-bar %= 2     // 1
-bar %= "foo" // NaN
-bar %= 0     // NaN
-
- -

Присваивание с левым сдвигом

- -

The left shift assignment operator moves the specified amount of bits to the left and assigns the result to the variable. See the {{jsxref("Operators/Bitwise_Operators", "left shift operator", "#Left_shift", 1)}} for more details.

- -

Синтаксис

- -
Оператор: x <<= y
-Значение:  x   = x << y
-
- -

Примеры

- -
var bar = 5; //  (00000000000000000000000000000101)
-bar <<= 2; // 20 (00000000000000000000000000010100)
-
- -

Присваивание с правым сдвигом

- -

The right shift assignment operator moves the specified amount of bits to the right and assigns the result to the variable. See the {{jsxref("Operators/Bitwise_Operators", "right shift operator", "#Right_shift", 1)}} for more details.

- -

Синтаксис

- -
Оператор: x >>= y
-Значение:  x   = x >> y
-
- -

Примеры

- -
var bar = 5; //   (00000000000000000000000000000101)
-bar >>= 2;   // 1 (00000000000000000000000000000001)
-
-var bar -5; //    (-00000000000000000000000000000101)
-bar >>= 2;  // -2 (-00000000000000000000000000000010)
-
- -

Присваивание с беззнаковым сдвигом вправо

- -

The unsigned right shift assignment operator moves the specified amount of bits to the right and assigns the result to the variable. See the {{jsxref("Operators/Bitwise_Operators", " unsigned right shift operator", "#Unsigned_right_shift", 1)}} for more details.

- -

Синтаксис

- -
Оператор: x >>>= y
-Значение:  x    = x >>> y
-
- -

Примеры

- -
var bar = 5; //   (00000000000000000000000000000101)
-bar >>>= 2;  // 1 (00000000000000000000000000000001)
-
-var bar = -5; // (-00000000000000000000000000000101)
-bar >>>= 2; // 1073741822 (00111111111111111111111111111110)
- -

Присваивание с побитовым AND

- -

The bitwise AND assignment operator uses the binary representation of both operands, does a bitwise AND operation on them and assigns the result to the variable. See the {{jsxref("Operators/Bitwise_Operators", "bitwise AND operator", "#Bitwise_AND", 1)}} for more details.

- -

Синтаксис

- -
Оператор: x &= y
-Значение:  x  = x & y
-
- -

Примеры

- -
var bar = 5;
-// 5:     00000000000000000000000000000101
-// 2:     00000000000000000000000000000010
-bar &= 2; // 0
-
- -

Присваивание с побитовым XOR

- -

Побитовый оператор присваивания XOR использует двоичное представление обоих операндов, выполняет побитовую XOR-операцию и присваивает результат переменной. Для получения более подробной информации см. {{jsxref("Operators/Bitwise_Operators", "Побитовый оператор XOR", "#Bitwise_XOR", 1)}}.

- -

Синтаксис

- -
Оператор: x ^= y
-Значение:  x  = x ^ y
-
- -

Примеры

- -
var bar = 5;
-bar ^= 2; // 7
-// 5: 00000000000000000000000000000101
-// 2: 00000000000000000000000000000010
-// -----------------------------------
-// 7: 00000000000000000000000000000111
-
- -

Присваиванием с побитовым OR

- -

Побитовый оператор присваивания OR использует двоичное (бинарное) представление обоих операндов, выполняет побитовое ИЛИ для них и присваивает результат переменной. Дополнительную информацию см. {{jsxref("Operators/Bitwise_Operators", "Побитовый оператор OR", "#Bitwise_OR", 1)}}.

- -

Синтаксис

- -
Оператор: x |= y
-Значение:  x  = x | y
-
- -

Примеры

- -
var bar = 5;
-bar |= 2; // 7
-// 5: 00000000000000000000000000000101
-// 2: 00000000000000000000000000000010
-// -----------------------------------
-// 7: 00000000000000000000000000000111
-
- -

Примеры

- -

Левый операнд с другим оператором присваивания

- -

В необычных ситуациях оператор присваивания, например, x += y не идентичен выражению, x = x + y. Когда левый операнд оператора присваивания содержит оператор присваивания, левый операнд оценивается только один раз. Например:

- -
a[i++] += 5         // i оценивается только один раз
-a[i++] = a[i++] + 5 // i оценивается дважды
-
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
ECMAScript 1-е издание.СтандартИзначальное определение.
{{SpecName('ES5.1', '#sec-11.13', 'Операторы присваивания')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-assignment-operators', 'Операторы присваивания')}}{{Spec2('ES6')}} 
- -

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

- -

{{ CompatibilityTable() }}

- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/operators/bitwise_operators/index.html b/files/ru/web/javascript/reference/operators/bitwise_operators/index.html deleted file mode 100644 index ba4703c2c3..0000000000 --- a/files/ru/web/javascript/reference/operators/bitwise_operators/index.html +++ /dev/null @@ -1,626 +0,0 @@ ---- -title: Битовые операции -slug: Web/JavaScript/Reference/Operators/Bitwise_Operators -tags: - - JavaScript - - Оператор -translation_of: Web/JavaScript/Reference/Operators -translation_of_original: Web/JavaScript/Reference/Operators/Bitwise_Operators ---- -
{{jsSidebar("Operators")}}
- -

Сводка

- -

Битовые операции обращаются со своими операндами как с 32-х разрядными последовательностями нулей и единиц, а не как с десятичными, восьмеричными или шестнадцатиричными числами. К примеру десятичное число 9 в двоичном представлении будет выглядеть как 1001. Битовые операции производят свои преобразования именно с двоичным представлением числа, но возвращают стандартные числовые значения языка JavaScript.

- - - - - - - - - - - - - - - -
Операторы
Реализованы в:JavaScript 1.0
Версия ECMA:ECMA-262
- -

Следующая таблица содержит сводные данные о битовых операциях в JavaScript:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ОператорИспользованиеОписание
Побитовое Иa & bВозвращает 1 в тех разрядах, которые у обоих операндов были равны 1.
Побитовое ИЛИa | bВозвращает 1 в тех разрядах, которые хотя бы у одного из операндов были равны 1.
Побитовое исключающее ИЛИa ^ bВозвращает 1 в тех позициях, которые только у одного из операндов были равны 1.
Побитовое НЕ~ aИнвертирует биты операнда.
Сдвиг влевоa << bСдвигает двоичное представление числа a на b разрядов влево заполняя освободившиеся справа разряды нулями.
Арифметический сдвиг вправоa >> bСдвигает двоичное представление числа a на b разрядов вправо. Освобождающиеся разряды заполняются  знаковым битом.
Логический сдвиг вправоa >>> bСдвигает двоичное представление числа a на b разрядов вправо. Освобождающиеся разряды заполняются нулями.
- -

Представление чисел (Signed 32-bit integers)

- -

Операнды всех битовых операций конвертируются в 32-х битовые целые со знаком представленные в дополнительном коде и с использованием порядка битов от "старшего к младшему". Порядок битов "от старшего к младшему" означает, что наиболее значимый бит (бит с наибольшим значением) находится слева если 32-х разрядное число представлено в виде горизонтальной линии (шкалы). Представление в дополнительном коде  означает, что отрицательное значение числа (например 5 и -5) получается путем инвертирования числа (операция "побитовое НЕ", также известное как "обратный код") и прибавления к нему единицы.

- -

Возьмем, к примеру, число 314. Представим его в двоичном коде:

- -
00000000000000000000000100111010
-
- -

Следующая строка представляет собой его обратный код или ~314:

- -
11111111111111111111111011000101
-
- -

Прибавив к нему единицу, мы получаем двоичное представление числа  -314, оно же 314 в дополнительном коде:

- -
11111111111111111111111011000110
- -

Дополнение до 2-х гарантирует нам, что у положительного числа самый левый бит равен 0, в то время как у отрицательного он равен 1. Он зовется знаковым битом.

- -


- Число 0 есть число, у которого во ввсех битовых позициях записаны нули.

- -
0 (base 10) = 00000000000000000000000000000000
- -

Число -1 есть число, у которого во всех битовых позициях записаны единицы.

- -
-1 (base 10) = 11111111111111111111111111111111
- -

Число -2147483648 (в шестнадцатиричной системе счисления: -0x80000000) - это вещественное число, которое состоит только из 0, заисключением самого первого слева, который есть 1 (отвечает за знак числа).

- -
-2147483648 (base 10) = 10000000000000000000000000000000
- -

Число 2147483648 (в шестнадцатиричной системе счисления: 0x80000000) - это вещественное число, которое состоит только из 1, заисключением самого первого слева, который есть 0 (отвечает за знак числа).

- -
2147483647 (base 10) = 01111111111111111111111111111111
- -

-2147483648 и 2147483647 - это самое минимальное и самое максимальное числа, которые можно представить в 32 разрядной ячейке памяти.

- -

Побитовые логические операции

- -

Побитовые логические операции работают следующим образом:

- - - -
До:         11100110111110100000000000000110000000000001
-После:      10100000000000000110000000000001
-
- - - -

& (Побитовое AND)

- -

Производит побитовое И над каждой парой битов. Операция a AND b веренет 1 если только и a и b равны 1. Таблица истинности для этой операции выглядит так:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
aba AND b
000
010
100
111
- -

Пример:

- -
     9 (основание 10) = 00000000000000000000000000001001 (основание 2)
-    14 (основание 10) = 00000000000000000000000000001110 (основание 2)
-                   --------------------------------
-14 & 9 (основание 10) = 00000000000000000000000000001000 (осн. 2) = 8 (осн. 10)
-
- -

Побитовое  AND любого числа x с нулем вернет 0.

- -

Побитовое  AND любого числа x с числом -1 вернет х.

- -

| (Побитовое OR)

- -

Производит побитовое ИЛИ над каждой парой битов. Операция a OR b веренет 1 если a или b равны 1. Таблица истинности для этой операции выглядит так:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
aba OR b
000
011
101
111
- -
Пример:
-
-9 (осн. 10) = 00000000000000000000000000001001 (осн. 2)
-14 (осн. 10) = 00000000000000000000000000001110 (осн. 2)
-                   --------------------------------
-14 | 9 (осн. 10) = 00000000000000000000000000001111 (осн. 2) = 15 (осн. 10)
-
- -

Побитовое OR любого числа x c нулем вернет x.

- -

Побитовое OR любого числа x с числом -1 вернет -1.

- -

^ (Побитовое XOR)

- -

Производит побитовое XOR над каждой парой битов. Операция a XOR b вернет 1 если a  и b различны. Таблица истинности для этой операции выглядит так:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
aba XOR b
000
011
101
110
- -

Пример:

- -
     9 (осн. 10) = 00000000000000000000000000001001 (осн. 2)
-    14 (осн. 10) = 00000000000000000000000000001110 (осн. 2)
-                   --------------------------------
-14 ^ 9 (осн. 10) = 00000000000000000000000000000111 (осн. 2) = 7 (осн. 10)
-
- -

Побитовое XOR любого числа x c нулем вернет x.

- -

Побитовое XOR любого числа x c числом -1 вернет ~x.

- -

~ (Побитовое NOT)

- -

Производит операцию NOT над каждым битом. NOT a вернет побитово инвертированное значение (обратный код) операнда. Таблица истинности для этой операции выглядит так:

- - - - - - - - - - - - - - - - -
aNOT a
01
10
- -

Пример:

- -
 9 (осн. 10) = 00000000000000000000000000001001 (осн. 2)
-               --------------------------------
-~9 (осн. 10) = 11111111111111111111111111110110 (осн. 2) = -10 (осн. 10)
-
- -

Побитовое NOT любого числа x вернет -(x + 1). Например, ~5 вернет -6.

- -

Побитовые операции сдвига

- -

Оператор побитового сдвига принимает в себя два операнда: первый - величина, которую сдвигают, второй - число позиций, на которое сдвигаются биты первого операнда. Направление сдвига зависит от используемого оператора.

- -

Операторы сдвига конвертируют операнды в 32-ух разрядные числа с порядком байтов от старшего к младшему, а результат возвращает того же типа, что и левый операнд.

- -

<< (Сдвиг влево)

- -

Оператор побитового сдвига влево сдвигает первый операнд на заданное число битов влево. Лишние биты отбрасываются.

- -

Например, 9 << 2 в результате даст 36:

- -
     9 (осн. 10): 00000000000000000000000000001001 (осн. 2)
-                  --------------------------------
-9 << 2 (осн. 10): 00000000000000000000000000100100 (осн. 2) = 36 (осн. 10)
-
-
-
- -

Побитовй сдвиг любого числа x влево на y бит в результате дает  x * 2 ** y.

- -

>> (Сдвиг вправо с сохранением знака)

- -

Оператор побитового сдвига вправо сдвигает первый операнд на заданное число битов вправо. Лишние биты отбрасываются. Слева добавляется заданное число битов равных первому биту исходного числа. Поскольку значение первого бита, определяющего знак числа, останется неизменным, знак получившегося результата будет таким же как у первого аргумента. Отсюда "с сохранением знака" в названи.

- -

Например, 9 >> 2 в результате даст 2:

- -
     9 (осн. 10): 00000000000000000000000000001001 (осн. 2)
-                  --------------------------------
-9 >> 2 (осн. 10): 00000000000000000000000000000010 (осн. 2) = 2 (осн. 10)
-
- -

Аналогично, -9 >> 2 даст в результате  -3, так как знак сохранен:

- -
     -9 (осн. 10): 11111111111111111111111111110111 (осн. 2)
-                   --------------------------------
--9 >> 2 (осн. 10): 11111111111111111111111111111101 (осн. 2) = -3 (осн. 10)
-
- -

>>> (Сдвиг вправо с заполнением нулями)

- -

Оператор побитового сдвига вправо сдвигает первый операнд на заданное число битов вправо. Лишние биты отбрасываются. Слева добавляется заданное число нулевых битов. Поскольку значение первого бита, определяющего знак числа, становится нулевым, результатом операции всегда будет положительное число.

- -

Для положительных чисел, сдвиг вправо с сохранением знака и сдвиг вправо с заполнением нулями эквивалентны.

- -

Например, 9 >>> 2 дает в результате 2, как и 9 >> 2:

- -
      9 (осн. 10): 00000000000000000000000000001001 (осн. 2)
-                   --------------------------------
-9 >>> 2 (осн. 10): 00000000000000000000000000000010 (осн. 2) = 2 (осн. 10)
-
- -

Важно отметить, что для отрицательных результаты будут разными. Например, -9 >>> 2 дает в результате 1073741821, что отличается от результата -9 >> 2 (равно -3):

- -
      -9 (осн. 10): 11111111111111111111111111110111 (осн. 2)
-                    --------------------------------
--9 >>> 2 (осн. 10): 00111111111111111111111111111101 (осн. 2) = 1073741821 (осн. 10)
-
- -

Примеры

- -

Пример: флаги и битовые маски

- -

Побитовые логические операторы часто используются для создания, обработки и чтения последовательности флагов, которые осуществляются также, как и двоичные переменные. Переменные могут быть использованы вместо этих последовательностей, но двоичные флаги занимают гораздо меньше памяти (в 32 разрядной ячейке памяти).

- -

Предположим, существует 4 флага:

- - - -

Эти флаги представлены последовательностью битов: DCBA. Считается, что флаг установлен (the flag is set), если его значение равно 1. Флаг сброшен (the flag is cleared), если его значение равно 0. Предположим, что переменная flags содержит двоичное значение 0101:

- -
var flags = 0x5;   // двоичное 0101
-
- -

Из этого значения следует:

- - - -

Так как битовые операторы 32-битные, то 0101 в действительности представлено значением 00000000000000000000000000000101, но ведущие нули могут быть опущены, потому, что не содержат значимой информации.

- -

Битовая маска, это последовательность битов, которая позволяет манипулировать и/или считывать значения флагов. Обычно для каждого флага задаётся "примитивная" битовая маска:

- -
var FLAG_A = 0x1; // 0001
-var FLAG_B = 0x2; // 0010
-var FLAG_C = 0x4; // 0100
-var FLAG_D = 0x8; // 1000
-
- -

New bitmasks can be created by using the bitwise logical operators on these primitive bitmasks. For example, the bitmask 1011 can be created by ORing FLAG_A, FLAG_B, and FLAG_D:

- -
var mask = FLAG_A | FLAG_B | FLAG_D; // 0001 | 0010 | 1000 => 1011
-
- -

Individual flag values can be extracted by ANDing them with a bitmask, where each bit with the value of one will "extract" the corresponding flag. The bitmask masks out the non-relevant flags by ANDing with zeros (hence the term "bitmask"). For example, the bitmask 0100 can be used to see if flag C is set:

- -
// if we own a cat
-if (flags & FLAG_C) { // 0101 & 0100 => 0100 => true
-   // do stuff
-}
-
- -

A bitmask with multiple set flags acts like an "either/or". For example, the following two are equivalent:

- -
// if we own a bat or we own a cat
-if ((flags & FLAG_B) || (flags & FLAG_C)) { // (0101 & 0010) || (0101 & 0100) => 0000 || 0100 => true
-   // do stuff
-}
-
- -
// if we own a bat or cat
-var mask = FLAG_B | FLAG_C; // 0010 | 0100 => 0110
-if (flags & mask) { // 0101 & 0110 => 0100 => true
-   // do stuff
-}
-
- -

Flags can be set by ORing them with a bitmask, where each bit with the value one will set the corresponding flag, if that flag isn't already set. For example, the bitmask 1010 can be used to set flags C and D:

- -
// yes, we own a cat and a duck
-var mask = FLAG_C | FLAG_D; // 0100 | 1000 => 1100
-flags |= mask;   // 0101 | 1100 => 1101
-
- -

Flags can be cleared by ANDing them with a bitmask, where each bit with the value zero will clear the corresponding flag, if it isn't already cleared. This bitmask can be created by NOTing primitive bitmasks. For example, the bitmask 1010 can be used to clear flags A and C:

- -
// no, we don't neither have an ant problem nor own a cat
-var mask = ~(FLAG_A | FLAG_C); // ~0101 => 1010
-flags &= mask;   // 1101 & 1010 => 1000
-
- -

The mask could also have been created with ~FLAG_A & ~FLAG_C (De Morgan's law):

- -
// no, we don't have an ant problem, and we don't own a cat
-var mask = ~FLAG_A & ~FLAG_C;
-flags &= mask;   // 1101 & 1010 => 1000
-
- -

Flags can be toggled by XORing them with a bitmask, where each bit with the value one will toggle the corresponding flag. For example, the bitmask 0110 can be used to toggle flags B and C:

- -
// if we didn't have a bat, we have one now, and if we did have one, bye-bye bat
-// same thing for cats
-var mask = FLAG_B | FLAG_C;
-flags = flags ^ mask;   // 1100 ^ 0110 => 1010
-
- -

Finally, the flags can all be flipped with the NOT operator:

- -
// entering parallel universe...
-flags = ~flags;    // ~1010 => 0101
-
-
- -

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

- -

{{ CompatibilityTable() }}

- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Битовый NOT (~){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Битовый AND (&){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Битовый OR (|){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Битовый XOR (^){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Сдвиг влево (<<){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Сдвиг вправо (>>){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Беззнаковый сдвиг вправо (>>>){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
-
- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Битовый NOT (~){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Битовый AND (&){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Битовый OR (|){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Битовый XOR (^){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Сдвиг влево (<<){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Сдвиг вправо (>>){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
Беззнаковый сдвиг вправо (>>>){{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}{{ CompatVersionUnknown() }}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/operators/comma_operator/index.html b/files/ru/web/javascript/reference/operators/comma_operator/index.html new file mode 100644 index 0000000000..471c81ba88 --- /dev/null +++ b/files/ru/web/javascript/reference/operators/comma_operator/index.html @@ -0,0 +1,103 @@ +--- +title: Оператор Запятая +slug: Web/JavaScript/Reference/Operators/Оператор_Запятая +tags: + - Оператор запятая +translation_of: Web/JavaScript/Reference/Operators/Comma_Operator +--- +
{{jsSidebar("Operators")}}
+ +

Оператор запятая выполняет каждый из его операндов (слева направо) и возвращает значение последнего операнда.

+ +
{{EmbedInteractiveExample("pages/js/expressions-commaoperators.html")}}
+ + + +

Синтаксис

+ +
expr1, expr2, expr3...
+ +

Параметры

+ +
+
expr1, expr2, expr3...
+
Любые выражения.
+
+ +

Описание

+ +

Вы можете использовать оператор запятая, когда необходимо включить несколько выражений в место, которое принимает только одно выражение. Наиболее частый пример использования этого оператора - это передача нескольких параметров в цикл for.

+ +

Примеры

+ +

Если a это двумерный массив элементов размерностью 10 х 10, то приведенный ниже код использует оператор запятая для одновременного изменения двух переменных за раз.

+ +

Следующий код выводит в консоль значения диагональных элементов массива:

+
for (let i = 0, j = 9; i <= 9; i++, j--)
+  console.log("a[" + i + "][" + j + "] = " + a[i][j]);
+ +

Заметьте, что запятая при объявлении переменной var, let или const не является оператором запятая, так как в данном случае она находится не в выражении. Скорее, это спец символ в объявлении переменных, комбинирующий их множество в одно выражение. Практически, эта запятая ведет себя почти так же, как и запятая.

+ +
  // подобное объявление запрещено в строгом режиме(strict mode)
+
+a = b = 3, c = 4; // возвращает 4 в консоль
+console.log(a); // 3
+x = (y = 5, z = 6); // возвращает 6 в консоль
+console.log(x); // 6
+
+ +

Оператор запятая полностью отличается от запятой в массивах, объектах, аргументах и параметрах функции.

+ +

Вычисления и возврат значения

+ +

Другой пример использования оператора запятой – вычисления перед возвратом значения. Как было указано ранее, будет возвращён только последний элемент, но все предыдущие также будут вычислены. Таким образом можно сделать:

+ +
function myFunc () {
+  let x = 0;
+
+  return (x += 1, x); // то же самое, что return ++x;
+}
+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ESDraft', '#sec-comma-operator', 'Comma operator')}}{{Spec2('ESDraft')}} 
{{SpecName('ES6', '#sec-comma-operator', 'Comma operator')}}{{Spec2('ES6')}} 
{{SpecName('ES5.1', '#sec-11.14', 'Comma operator')}}{{Spec2('ES5.1')}} 
{{SpecName('ES1', '#sec-11.14', 'Comma operator')}}{{Spec2('ES1')}}Initial definition
+ +

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

+ + + +

{{Compat("javascript.operators.comma")}}

+ +

Смотри также

+ + diff --git a/files/ru/web/javascript/reference/operators/conditional_operator/index.html b/files/ru/web/javascript/reference/operators/conditional_operator/index.html new file mode 100644 index 0000000000..344d7f21d9 --- /dev/null +++ b/files/ru/web/javascript/reference/operators/conditional_operator/index.html @@ -0,0 +1,169 @@ +--- +title: Условный (тернарный) оператор +slug: Web/JavaScript/Reference/Operators/Условный_оператор +tags: + - JavaScript + - Оператор +translation_of: Web/JavaScript/Reference/Operators/Conditional_Operator +--- +
{{jsSidebar("Operators")}}
+ +

Условный (тернарный) оператор - единственный оператор в JavaScript, принимающий три операнда: условие, за которым следует знак вопроса (?), затем выражение, которое выполняется, если условие истинно, сопровождается двоеточием (:), и, наконец, выражение, которое выполняется, если условие ложно. Он часто используется в качестве укороченного варианта условного оператора if.

+ +

Синтаксис

+ +
условие ? выражение1 : выражение2
+ +

Параметры

+ +
+
условие
+
Выражение, принимающее значение true или false.
+
+ +
+
выражение1, выражение2
+
Выражения, значения которых могут принадлежать любому типу.
+
+ +

Описание

+ +

Оператор возвращает значение выражения1, если условие верно, и значение выражения2 в противном случае. Например, чтобы вывести сообщение, текст которого зависит от значения переменной isMember, можно использовать такое выражение:

+ +
"The fee is " + (isMember ? "$2.00" : "$10.00")
+
+ +

Также можно присваивать значения переменным на основе результатов работы тернарного оператора :

+ +
var elvisLives = Math.PI > 4 ? "Да" : "Нет";
+ +

Возможны множественные тернарные операции (обратите внимание: условный оператор ассоциативен справа):

+ +
var firstCheck = false,
+    secondCheck = false,
+    access = firstCheck ? "Доступ запрещен" : secondCheck ? "Доступ запрещен" : "Доступ разрешен";
+
+console.log( access ); // выводит в консоль "Доступ разрешен"
+ +

Тернарные операции можно использовать и сами по себе - для выполнения различных операций:

+ +
var stop = false, age = 16;
+
+age > 18 ? location.assign("continue.html") : stop = true;
+
+ +

Также возможно выполнять несколько операций на каждое сравнение, разделив их запятыми:

+ +
var stop = false, age = 23;
+
+age > 18 ? (
+    alert("Хорошо, вы можете продолжить."),
+    location.assign("continue.html")
+) : (
+    stop = true,
+    alert("Простите, вы еще так юны!")
+);
+
+ +

При присвоении значения также возможно выполнение более одной операции. В этом случае переменной будет присвоено то значение, которое стоит последним в списке значений, разделенных запятой.

+ +
var age = 16;
+
+var url = age > 18 ? (
+    alert("Хорошо, вы можете продолжить."),
+    // alert вернет "undefined", но это будет проигнорировано, потому что
+    // не является последним в списке значений, разделенных запятой
+    "continue.html" // значение будет присвоено, если age > 18
+) : (
+    alert("Вы слишком молоды!"),
+    alert("Простите :-("),
+    // ит.д. ит.д.
+    "stop.html" // значение будет присвоено, если !(age > 18)
+);
+
+location.assign(url); // "stop.html"
+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES6', '#sec-conditional-operator', 'Условный Оператор')}}{{Spec2('ES6')}}
{{SpecName('ES5.1', '#sec-11.12', 'Условный оператор')}}{{Spec2('ES5.1')}}
{{SpecName('ES1', '#sec-11.12', 'Условный оператор')}}{{Spec2('ES1')}}Изначальное определение. Реализация в JavaScript 1.0.
+ +

Поддержка браузерами

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
ОсобенностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
ОсобенностьAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

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

+ + diff --git a/files/ru/web/javascript/reference/operators/grouping/index.html b/files/ru/web/javascript/reference/operators/grouping/index.html new file mode 100644 index 0000000000..ecc180ab21 --- /dev/null +++ b/files/ru/web/javascript/reference/operators/grouping/index.html @@ -0,0 +1,91 @@ +--- +title: Оператор группировки +slug: Web/JavaScript/Reference/Operators/Группировка +tags: + - JavaScript + - Оператор + - Основные выражения +translation_of: Web/JavaScript/Reference/Operators/Grouping +--- +
{{jsSidebar("Operators")}}
+ +

Оператор группировки ( ) контролирует порядок выполнения в выражениях.

+ +
{{EmbedInteractiveExample("pages/js/expressions-groupingoperator.html")}}
+ + + +

Синтаксис

+ +
 ( )
+ +

Описание

+ +

Оператор группировки из пары круглых скобок вокруг выражения или подвыражения, переопределяющего нормальный приоритет операторов, так что выражения с меньшим приоритетом выполняются раньше выражений с большим.

+ +

Примеры

+ +

Переопределяем порядок, когда сначала выполняется умножение и деление, а потом сложение и вычитание, чтобы сначала выполнить сложение.

+ +
let a = 1;
+let b = 2;
+let c = 3;
+
+// обычный порядок
+a + b * c     // 7
+// выполнится так
+a + (b * c)   // 7
+
+// теперь переопределим порядок
+// сложение будет до умножения
+(a + b) * c   // 9
+
+// что эквивалентно следующему
+a * c + b * c // 9
+
+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ESDraft', '#sec-grouping-operator', 'The Grouping Operator')}}{{Spec2('ESDraft')}} 
{{SpecName('ES6', '#sec-grouping-operator', 'The Grouping Operator')}}{{Spec2('ES6')}} 
{{SpecName('ES5.1', '#sec-11.1.6', 'The Grouping Operator')}}{{Spec2('ES5.1')}} 
{{SpecName('ES1', '#sec-11.1.4', 'The Grouping Operator')}}{{Spec2('ES1')}}Изначальное определение.
+ +

Поддержка браузерами

+ + + +

{{Compat("javascript.operators.grouping")}}

+ +

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

+ + diff --git a/files/ru/web/javascript/reference/operators/pipeline_operator/index.html b/files/ru/web/javascript/reference/operators/pipeline_operator/index.html new file mode 100644 index 0000000000..fa43c6d346 --- /dev/null +++ b/files/ru/web/javascript/reference/operators/pipeline_operator/index.html @@ -0,0 +1,77 @@ +--- +title: Конвейерный оператор +slug: Web/JavaScript/Reference/Operators/Конвейерный_оператор +tags: + - Experimental + - JavaScript + - Operator + - Оператор + - Экспериментальный +translation_of: Web/JavaScript/Reference/Operators/Pipeline_operator +--- +
{{jsSidebar("Operators")}} {{SeeCompatTable}}
+ +

Экспериментальный конвейерный оператор |> (в настоящее время на этапе 1) позволяет создавать читаемые цепочки вызовов функций. В основном, конвейерный оператор предоставляет возможность вызова функции с одним аргументом, и позволяет написать:

+ +
let url = "%21" |> decodeURI;
+
+ +

Эквивалентный вызов в традиционном синтаксисе выглядит следующим образом:

+ +
let url = decodeURI("%21");
+
+ +

Синтаксис

+ +
выражение |> функция
+ +

Значение указанного выражения передаётся в функцию в качестве единственного параметра.

+ +

Примеры

+ +

Цепочки вызовов функций

+ +

Конвейерный оператор позволяет улучшить читаемость кода, в случае когда встречается цепочка из нескольких функций.

+ +
const double = (n) => n * 2;
+const increment = (n) => n + 1;
+
+// без конвейерного оператора
+double(increment(double(double(5)))); // 42
+
+// с конвейерным оператором
+5 |> double |> double |> increment |> double; // 42
+
+ +

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

+ + + + + + + + + + + + + + + + +
СпецификацияСтатусComment
Pipeline operator draftЭтап 1Еще не включен в спецификацию ECMAScript.
+ +

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

+ +
+ + +

{{Compat("javascript.operators.pipeline")}}

+
+ +

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

+ + diff --git "a/files/ru/web/javascript/reference/operators/\320\263\321\200\321\203\320\277\320\277\320\270\321\200\320\276\320\262\320\272\320\260/index.html" "b/files/ru/web/javascript/reference/operators/\320\263\321\200\321\203\320\277\320\277\320\270\321\200\320\276\320\262\320\272\320\260/index.html" deleted file mode 100644 index ecc180ab21..0000000000 --- "a/files/ru/web/javascript/reference/operators/\320\263\321\200\321\203\320\277\320\277\320\270\321\200\320\276\320\262\320\272\320\260/index.html" +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: Оператор группировки -slug: Web/JavaScript/Reference/Operators/Группировка -tags: - - JavaScript - - Оператор - - Основные выражения -translation_of: Web/JavaScript/Reference/Operators/Grouping ---- -
{{jsSidebar("Operators")}}
- -

Оператор группировки ( ) контролирует порядок выполнения в выражениях.

- -
{{EmbedInteractiveExample("pages/js/expressions-groupingoperator.html")}}
- - - -

Синтаксис

- -
 ( )
- -

Описание

- -

Оператор группировки из пары круглых скобок вокруг выражения или подвыражения, переопределяющего нормальный приоритет операторов, так что выражения с меньшим приоритетом выполняются раньше выражений с большим.

- -

Примеры

- -

Переопределяем порядок, когда сначала выполняется умножение и деление, а потом сложение и вычитание, чтобы сначала выполнить сложение.

- -
let a = 1;
-let b = 2;
-let c = 3;
-
-// обычный порядок
-a + b * c     // 7
-// выполнится так
-a + (b * c)   // 7
-
-// теперь переопределим порядок
-// сложение будет до умножения
-(a + b) * c   // 9
-
-// что эквивалентно следующему
-a * c + b * c // 9
-
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ESDraft', '#sec-grouping-operator', 'The Grouping Operator')}}{{Spec2('ESDraft')}} 
{{SpecName('ES6', '#sec-grouping-operator', 'The Grouping Operator')}}{{Spec2('ES6')}} 
{{SpecName('ES5.1', '#sec-11.1.6', 'The Grouping Operator')}}{{Spec2('ES5.1')}} 
{{SpecName('ES1', '#sec-11.1.4', 'The Grouping Operator')}}{{Spec2('ES1')}}Изначальное определение.
- -

Поддержка браузерами

- - - -

{{Compat("javascript.operators.grouping")}}

- -

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

- - diff --git "a/files/ru/web/javascript/reference/operators/\320\272\320\276\320\275\320\262\320\265\320\271\320\265\321\200\320\275\321\213\320\271_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200/index.html" "b/files/ru/web/javascript/reference/operators/\320\272\320\276\320\275\320\262\320\265\320\271\320\265\321\200\320\275\321\213\320\271_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200/index.html" deleted file mode 100644 index fa43c6d346..0000000000 --- "a/files/ru/web/javascript/reference/operators/\320\272\320\276\320\275\320\262\320\265\320\271\320\265\321\200\320\275\321\213\320\271_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200/index.html" +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Конвейерный оператор -slug: Web/JavaScript/Reference/Operators/Конвейерный_оператор -tags: - - Experimental - - JavaScript - - Operator - - Оператор - - Экспериментальный -translation_of: Web/JavaScript/Reference/Operators/Pipeline_operator ---- -
{{jsSidebar("Operators")}} {{SeeCompatTable}}
- -

Экспериментальный конвейерный оператор |> (в настоящее время на этапе 1) позволяет создавать читаемые цепочки вызовов функций. В основном, конвейерный оператор предоставляет возможность вызова функции с одним аргументом, и позволяет написать:

- -
let url = "%21" |> decodeURI;
-
- -

Эквивалентный вызов в традиционном синтаксисе выглядит следующим образом:

- -
let url = decodeURI("%21");
-
- -

Синтаксис

- -
выражение |> функция
- -

Значение указанного выражения передаётся в функцию в качестве единственного параметра.

- -

Примеры

- -

Цепочки вызовов функций

- -

Конвейерный оператор позволяет улучшить читаемость кода, в случае когда встречается цепочка из нескольких функций.

- -
const double = (n) => n * 2;
-const increment = (n) => n + 1;
-
-// без конвейерного оператора
-double(increment(double(double(5)))); // 42
-
-// с конвейерным оператором
-5 |> double |> double |> increment |> double; // 42
-
- -

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

- - - - - - - - - - - - - - - - -
СпецификацияСтатусComment
Pipeline operator draftЭтап 1Еще не включен в спецификацию ECMAScript.
- -

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

- -
- - -

{{Compat("javascript.operators.pipeline")}}

-
- -

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

- - diff --git "a/files/ru/web/javascript/reference/operators/\320\273\320\276\320\263\320\270\321\207\320\265\321\201\320\272\320\270\320\265_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200\321\213/index.html" "b/files/ru/web/javascript/reference/operators/\320\273\320\276\320\263\320\270\321\207\320\265\321\201\320\272\320\270\320\265_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200\321\213/index.html" deleted file mode 100644 index b840f1e584..0000000000 --- "a/files/ru/web/javascript/reference/operators/\320\273\320\276\320\263\320\270\321\207\320\265\321\201\320\272\320\270\320\265_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200\321\213/index.html" +++ /dev/null @@ -1,300 +0,0 @@ ---- -title: Логические операторы -slug: Web/JavaScript/Reference/Operators/Логические_операторы -translation_of: Web/JavaScript/Reference/Operators -translation_of_original: Web/JavaScript/Reference/Operators/Logical_Operators ---- -
{{jsSidebar("Operators")}}
- -
Логические операторы используются, как правило, с примитивами {{jsxref("Boolean")}} (логического) типа. В этом случае результатом работы оператора является значение типа Boolean. Между тем операторы && и || возвращают, вообще говоря, значение одного из операнда, потому при использовании в качестве аргументов этих операторов величин, тип которых отличен от Boolean, тип возвращаемого значения может быть отличным от Boolean.
- -
- -

Описание

- -

В таблице приведены описания логических операторов:

- - - - - - - - - - - - - - - - - - - - - - - - -
ОператорИспользованиеОписание
Логическое И (&&)expr1 && expr2Возвращает значение expr1, если оно может быть преобразовано в false; иначе возвращает значение expr2. Таким образом, при использовании с величинами типа Boolean оператор && вернет true, если оба операнда могут быть преобразованы в true; иначе оператор && вернет false. 
Логическое ИЛИ (||)expr1 || expr2 -

Возвращает значение expr1, если оно может быть преобразовано в true; иначе возвращает значение expr2. Таким образом, при использовании с величинами типа Boolean оператор || вернет true если хоть один из них равен true; в других случаях вернет false.

-
Логическое НЕ (!)!exprВозвращает false если значение expr можно привести к true;  в противоположном случае возвращает true.
- -

Примеры значений выражений, которые могут быть преобразованы в false:

- - - -

Хоть операторы && и || могут использовать операнды с не булевыми значениями, но они всёравно рассматриваются, как булевы операторы, т.к. их возвращаемые ими значения всегда могут быть сконвертированы в булевы значения.

- -

Короткая схема вычислений

- -

Так как логические операторы выполняются слева направо, они проверяются на "короткие вычисления" по следующим правилам:

- - - -

Часть выражения (anything) не вычисляется. Если в ней есть вызов функции, то эта функция не будет вызвана.

- -

Например, следующие две функции делают одно и тоже:

- -
function shortCircuitEvaluation() {
-  doSomething() || doSomethingElse()
-}
-
-function equivalentEvaluation() {
-  var flag = doSomething();
-  if (!flag) {
-    doSomethingElse();
-  }
-}
-
- -

Однако, следующие выражения дают разный результат в связи с приоритетом операторов.

- -
false && true  || true      // вернёт true
-false && (true || true)     // вернёт false
- -

Логическое И (&&)

- -

Следующий код показывает пример оператора && (логическое И).

- -
a1 = true  && true      // t && t вернёт true
-a2 = true  && false     // t && f вернёт false
-a3 = false && true      // f && t вернёт false
-a4 = false && (3 == 4)  // f && f вернёт false
-a5 = "Cat" && "Dog"     // t && t вернёт "Dog"
-a6 = false && "Cat"     // f && t вернёт false
-a7 = "Cat" && false     // t && f вернёт false
-
- -

Логическое ИЛИ (||)

- -

Это код представляет собой пример оператора || (логическое ИЛИ).

- -
o1 = true  || true       // t || t вернёт true
-o2 = false || true       // f || t вернёт true
-o3 = true  || false      // t || f вернёт true
-o4 = false || (3 == 4)   // f || f вернёт false
-o5 = "Cat" || "Dog"      // t || t вернёт "Cat"
-o6 = false || "Cat"      // f || t вернёт "Cat"
-o7 = "Cat" || false      // t || f вернёт "Cat"
-
- -

Логическое НЕ (!)

- -

Следующий код является примером оператора ! (логическое НЕ).

- -
n1 = !true              // !t вернёт false
-n2 = !false             // !f вернёт true
-n3 = !"Cat"             // !t вернёт false
-
- -

Правила преобразования

- -

Конвертирование И в ИЛИ

- -

следующая операция использует булев тип:

- -
bCondition1 && bCondition2
- -

это всегда равно:

- -
!(!bCondition1 || !bCondition2)
- -

Конвертирование ИЛИ в И

- -

эта операция использует булев тип:

- -
bCondition1 || bCondition2
- -

что эквивалентно:

- -
!(!bCondition1 && !bCondition2)
- -

Конвертирование многих НЕ

- -

следующая операция использует булев тип:

- -
!!bCondition
- -

что равно:

- -
bCondition
- -

Удаление вложенных скобок

- -

Так как логические выражения выполняются слева направо, становится возможным удалить круглые скобки из комплексного выражения, следуя следующим правилам.

- -

Удаление вложенных И

- -

Это составное выражение использует булев тип:

- -
bCondition1 || (bCondition2 && bCondition3)
- -

что будет равным:

- -
bCondition1 || bCondition2 && bCondition3
- -

Удаление вложенного ИЛИ

- -

Следующее составное выражение использует булев тип:

- -
bCondition1 && (bCondition2 || bCondition3)
- -

всегда равно:

- -
!(!bCondition1 || !bCondition2 && !bCondition3)
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES5.1')}}{{Spec2('ES1')}}Изначальное определение
{{SpecName('ES5.1', '#sec-11.11')}}{{Spec2('ES5.1')}}Определено в нескольких секциях спецификации: Логический оператор НЕ, Бинарные логические операторы
{{SpecName('ES6', '#sec-binary-logical-operators')}}{{Spec2('ES6')}}Определено в нескольких секциях спецификации: Логический оператор НЕ, Бинарные логические операторы
{{SpecName('ESDraft', '#sec-binary-logical-operators')}}{{Spec2('ESDraft')}}Определено в нескольких секциях спецификации: Логический оператор НЕ, Бинарные логические операторы
- -

Поддержка браузерами

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Логическое И (&&){{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Логическое ИЛИ (||){{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Логическое НЕ (!){{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Логическое И (&&){{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Логическое ИЛИ (||){{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
Логическое НЕ (!){{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- - diff --git "a/files/ru/web/javascript/reference/operators/\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200_\320\267\320\260\320\277\321\217\321\202\320\260\321\217/index.html" "b/files/ru/web/javascript/reference/operators/\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200_\320\267\320\260\320\277\321\217\321\202\320\260\321\217/index.html" deleted file mode 100644 index 471c81ba88..0000000000 --- "a/files/ru/web/javascript/reference/operators/\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200_\320\267\320\260\320\277\321\217\321\202\320\260\321\217/index.html" +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: Оператор Запятая -slug: Web/JavaScript/Reference/Operators/Оператор_Запятая -tags: - - Оператор запятая -translation_of: Web/JavaScript/Reference/Operators/Comma_Operator ---- -
{{jsSidebar("Operators")}}
- -

Оператор запятая выполняет каждый из его операндов (слева направо) и возвращает значение последнего операнда.

- -
{{EmbedInteractiveExample("pages/js/expressions-commaoperators.html")}}
- - - -

Синтаксис

- -
expr1, expr2, expr3...
- -

Параметры

- -
-
expr1, expr2, expr3...
-
Любые выражения.
-
- -

Описание

- -

Вы можете использовать оператор запятая, когда необходимо включить несколько выражений в место, которое принимает только одно выражение. Наиболее частый пример использования этого оператора - это передача нескольких параметров в цикл for.

- -

Примеры

- -

Если a это двумерный массив элементов размерностью 10 х 10, то приведенный ниже код использует оператор запятая для одновременного изменения двух переменных за раз.

- -

Следующий код выводит в консоль значения диагональных элементов массива:

-
for (let i = 0, j = 9; i <= 9; i++, j--)
-  console.log("a[" + i + "][" + j + "] = " + a[i][j]);
- -

Заметьте, что запятая при объявлении переменной var, let или const не является оператором запятая, так как в данном случае она находится не в выражении. Скорее, это спец символ в объявлении переменных, комбинирующий их множество в одно выражение. Практически, эта запятая ведет себя почти так же, как и запятая.

- -
  // подобное объявление запрещено в строгом режиме(strict mode)
-
-a = b = 3, c = 4; // возвращает 4 в консоль
-console.log(a); // 3
-x = (y = 5, z = 6); // возвращает 6 в консоль
-console.log(x); // 6
-
- -

Оператор запятая полностью отличается от запятой в массивах, объектах, аргументах и параметрах функции.

- -

Вычисления и возврат значения

- -

Другой пример использования оператора запятой – вычисления перед возвратом значения. Как было указано ранее, будет возвращён только последний элемент, но все предыдущие также будут вычислены. Таким образом можно сделать:

- -
function myFunc () {
-  let x = 0;
-
-  return (x += 1, x); // то же самое, что return ++x;
-}
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ESDraft', '#sec-comma-operator', 'Comma operator')}}{{Spec2('ESDraft')}} 
{{SpecName('ES6', '#sec-comma-operator', 'Comma operator')}}{{Spec2('ES6')}} 
{{SpecName('ES5.1', '#sec-11.14', 'Comma operator')}}{{Spec2('ES5.1')}} 
{{SpecName('ES1', '#sec-11.14', 'Comma operator')}}{{Spec2('ES1')}}Initial definition
- -

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

- - - -

{{Compat("javascript.operators.comma")}}

- -

Смотри также

- - diff --git "a/files/ru/web/javascript/reference/operators/\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200\321\213_\321\201\321\200\320\260\320\262\320\275\320\265\320\275\320\270\321\217/index.html" "b/files/ru/web/javascript/reference/operators/\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200\321\213_\321\201\321\200\320\260\320\262\320\275\320\265\320\275\320\270\321\217/index.html" deleted file mode 100644 index ee0565dc94..0000000000 --- "a/files/ru/web/javascript/reference/operators/\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200\321\213_\321\201\321\200\320\260\320\262\320\275\320\265\320\275\320\270\321\217/index.html" +++ /dev/null @@ -1,286 +0,0 @@ ---- -title: Операторы сравнения -slug: Web/JavaScript/Reference/Operators/Операторы_сравнения -tags: - - JavaScript - - Операторы -translation_of: Web/JavaScript/Reference/Operators -translation_of_original: Web/JavaScript/Reference/Operators/Comparison_Operators ---- -
{{jsSidebar("Operators")}}
- -

В JavaScript имеются как строгие сравнения, так и сравнения с преобразованием типа операндов. Строгие сравнения (к примеру, ===) истинны только в том случае, если типы сравниваемых значений являются одинаковыми (к примеру: string-string, number-number). Однако, чаще используются сравнения с преобразованием типов (к примеру, ==). Такой тип сравнения, перед тем как непосредственно выполнить сравнение, приводит операнды к одному типу. В случае же абстрактного реляционного сравнения, операнды сперва преобразуются в примитивы, затем приводятся к одному типу, и только после этого сравниваются.

- -

Строки сравниваются на основе стандартного лексикографического упорядочения, используя значения Unicode.

- -

Особенности сравнений:

- - - -

При использовании сравнения с преобразованием типов, следует быть крайне осторожным, так как это может привести к непредвиденным проблемам, связанным с особенностями конвертации различных типов (см. параграф "Использование операторов равенства").

- -

Операторы равенства

- -

Равно (==)

- -

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

- -

Синтаксис

- -
x == y
-
- -

Примеры

- -
 1  ==  1      // истина
-"1" ==  1      // истина
- 1  == '1'     // истина
- 3  ==  5      // ложь
- 0  == false   // истина
-"foo" == "bar" // ложь
-
- -

Не равно (!=)

- -

Оператор не равно возвращает true в том случае, если операнды не равны.Он аналогичен оператору равенства, перед сравнением приводит операнды к одному типу. В случае если оба операнда являются объектами,  JavaScript сравнивает внутренние ссылки, которые не равны в том случае, если относятся к разным объектам в памяти.

- -

Синтаксис

- -
x != y
- -

Примеры

- -
1 !=   2       // истина
-1 !=  "1"      // ложь
-1 !=  '1'      // ложь
-1 !=  true     // ложь
-0 !=  false    // ложь
-"foo" != "bar" // истина
-
- -

Строго равно (===)

- -

Оператор возвращает истину в том случае, если операнды строго равны (см. выше). В отличие от оператора равно, данный оператор не приводит операнды к одному типу.

- -

Синтаксис

- -
x === y
- -

Примеры

- -
3 === 3   // истина
-3 === '3' // ложь
-'foo' === 'foo' // истина
-
- -

Строго не равно (!==)

- -

Оператор строго не равно возвращает истину в том случае, если операнды не равны, или их типы отличаются друг от друга.

- -

Синтаксис

- -
x !== y
- -

Примеры

- -
3 !== '3' // истина
-4 !== 3   // истина
-
- -

Операторы сравнения

- -

Больше (>)

- -

Оператор больше возвращает истину в том случае, если значение левого операнда больше, чем правого.

- -

Синтаксис

- -
x > y
- -

Примеры

- -
4 > 3 // истина
-1 > 5 // ложь
-
- -

Больше или равно (>=)

- -

Оператор больше или равно, возвращает истину в том случае, если значение операнда слева больше или равно значению операнда справа.

- -

Синтаксис

- -
 x >= y
- -

Примеры

- -
4 >= 3 // истина
-3 >= 3 // истина
-
- -

Меньше(<)

- -

Оператор меньше, возвращает истину в том случае, если значение операнда слева меньше, чем значение операнда справа.

- -

Синтаксис

- -
 x < y
- -

Примеры

- -
3 < 4 // истина
-5 < 2 // ложь
-
- -

Меньше или равно (<=)

- -

Оператор меньше или равно, возвращает истину в том случае, если значение операнда слева меньше, или равно значению операнда справа.

- -

Синтаксис

- -
 x <= y
- -

Примеры

- -
3 <= 4 // истина
-3 <= 3 // истина
-
- -

Использование операторов равенства

- -

Стандартные операции равенства с преобразованием типов (== и !=) используют Абстрактный Алгоритм Эквивалентного Сравнения для сравнения двух операндов. Если у операндов различные типы, то JavaScript пытается привести их к одному типу, перед тем как сравнивать их. К примеру, в выражении 5 == '5', строка справа конвертируется в число, и только потом сравнивается.

- -

Операторы строгого равентсва (=== и !==) используют Строгий Алгоритм Эквивалентного Сравнения, и предназначены для сравнения операндов одного типа. Если операнды имеют разные типы, то результат операции сравнения всегда будет ложью. К примеру, выражение 5 !== '5' будет истинным.

- -

Используйте операторы строгого равенства в тех случаях, когда необходимо проверять не только значения операндов, но так же и их типы. Во противном случае, используйте операторы стандартного равенства, которые позволяют сравнить два операнда вне зависимости от их типов.

- -

Когда происходит преобразование типов (т.е в случаях использования нестрогого сравнения), JavaScript преобразует типы String, Number, Boolean и Object, следующим образом:

- - - -
Внимание: Объекты String имеют тип Object, а не String. Такие объекты используются редко, так что следующий код может вас сильно удивить.
- -
// Истина, так как оба операнда имеют тип String
-'foo' === 'foo'
-
-var a = new String('foo');
-var b = new String('foo');
-
-// Ложь, так как операнды являются объектами, внутренние ссылки которых, ссылаются на разные объекты в памяти
-a == b
-
-// Ложь, так как операнды являются объектами, внутренние ссылки которых, ссылаются на разные объекты в памяти
-a === b
-
-// Истина, так как объект a (String) будет преобразован в строку 'foo', перед сопоставлением
-a == 'foo'
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES1')}}{{Spec2('ES1')}}Появление в спецификации. Выполняется в JavaScript 1.0
{{SpecName('ES3')}}{{Spec2('ES3')}}Добавлены операторы === и !==. Выполняется в JavaScript 1.3
{{SpecName('ES5.1', '#sec-11.8')}}{{Spec2('ES5.1')}}Определено в нескольких секциях спецификации: Относительные операторы, Операторы равенства
{{SpecName('ES6', '#sec-relational-operators')}}{{Spec2('ES6')}}Определено в нескольких секциях спецификации: Относительные операторы, Операторы равенства
{{SpecName('ESDraft', '#sec-relational-operators')}}{{Spec2('ESDraft')}}Определено в нескольких секциях спецификации: Относительные операторы, Операторы равенства
- -

Поддержка браузерами

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
ChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}} -

{{CompatVersionUnknown}}

-
-
- -
- - - - - - - - - - - - - - - - - - - - - -
AndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -


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

- - diff --git "a/files/ru/web/javascript/reference/operators/\320\277\321\200\320\270\321\201\320\262\320\260\320\270\320\262\320\260\320\275\320\270\320\265/index.html" "b/files/ru/web/javascript/reference/operators/\320\277\321\200\320\270\321\201\320\262\320\260\320\270\320\262\320\260\320\275\320\270\320\265/index.html" deleted file mode 100644 index 0517dc2ccd..0000000000 --- "a/files/ru/web/javascript/reference/operators/\320\277\321\200\320\270\321\201\320\262\320\260\320\270\320\262\320\260\320\275\320\270\320\265/index.html" +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Присваивание (=) -slug: Web/JavaScript/Reference/Operators/Присваивание -tags: - - Assignment operator - - JavaScript - - Language feature - - Operator - - Reference - - Оператор - - Оператор присваивания - - "Особенность\_языка" - - справочник -translation_of: Web/JavaScript/Reference/Operators/Assignment ---- -
{{jsSidebar("Operators")}}
- -

Простой оператор присваивания (=) используется для присваивания значения переменной. Операция присваивания вычисляется в присваиваемую величину. Присваивание по цепочке (chaining) используется для назначения нескольким переменным одинакового значения.

- -

{{EmbedInteractiveExample("pages/js/expressions-assignment.html")}}

- -
- - - -

Синтаксис

- -
Оператор: x = y
-
- -

Примеры

- -

Простое и цепное присваивание

- -
// Предположим следующие переменные и их значения
-//  x = 5
-//  y = 10
-//  z = 25
-
-x = y     // x будет присвоено значение 10
-x = y = z // x, y и z будут равны 25
- -

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

- - - - - - - - - - -
Specification
{{SpecName('ESDraft', '#sec-assignment-operators', 'Assignment operators')}}
- -

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

- - - -

{{Compat("javascript.operators.assignment")}}

- -

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

- - diff --git "a/files/ru/web/javascript/reference/operators/\321\203\321\201\320\273\320\276\320\262\320\275\321\213\320\271_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200/index.html" "b/files/ru/web/javascript/reference/operators/\321\203\321\201\320\273\320\276\320\262\320\275\321\213\320\271_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200/index.html" deleted file mode 100644 index 344d7f21d9..0000000000 --- "a/files/ru/web/javascript/reference/operators/\321\203\321\201\320\273\320\276\320\262\320\275\321\213\320\271_\320\276\320\277\320\265\321\200\320\260\321\202\320\276\321\200/index.html" +++ /dev/null @@ -1,169 +0,0 @@ ---- -title: Условный (тернарный) оператор -slug: Web/JavaScript/Reference/Operators/Условный_оператор -tags: - - JavaScript - - Оператор -translation_of: Web/JavaScript/Reference/Operators/Conditional_Operator ---- -
{{jsSidebar("Operators")}}
- -

Условный (тернарный) оператор - единственный оператор в JavaScript, принимающий три операнда: условие, за которым следует знак вопроса (?), затем выражение, которое выполняется, если условие истинно, сопровождается двоеточием (:), и, наконец, выражение, которое выполняется, если условие ложно. Он часто используется в качестве укороченного варианта условного оператора if.

- -

Синтаксис

- -
условие ? выражение1 : выражение2
- -

Параметры

- -
-
условие
-
Выражение, принимающее значение true или false.
-
- -
-
выражение1, выражение2
-
Выражения, значения которых могут принадлежать любому типу.
-
- -

Описание

- -

Оператор возвращает значение выражения1, если условие верно, и значение выражения2 в противном случае. Например, чтобы вывести сообщение, текст которого зависит от значения переменной isMember, можно использовать такое выражение:

- -
"The fee is " + (isMember ? "$2.00" : "$10.00")
-
- -

Также можно присваивать значения переменным на основе результатов работы тернарного оператора :

- -
var elvisLives = Math.PI > 4 ? "Да" : "Нет";
- -

Возможны множественные тернарные операции (обратите внимание: условный оператор ассоциативен справа):

- -
var firstCheck = false,
-    secondCheck = false,
-    access = firstCheck ? "Доступ запрещен" : secondCheck ? "Доступ запрещен" : "Доступ разрешен";
-
-console.log( access ); // выводит в консоль "Доступ разрешен"
- -

Тернарные операции можно использовать и сами по себе - для выполнения различных операций:

- -
var stop = false, age = 16;
-
-age > 18 ? location.assign("continue.html") : stop = true;
-
- -

Также возможно выполнять несколько операций на каждое сравнение, разделив их запятыми:

- -
var stop = false, age = 23;
-
-age > 18 ? (
-    alert("Хорошо, вы можете продолжить."),
-    location.assign("continue.html")
-) : (
-    stop = true,
-    alert("Простите, вы еще так юны!")
-);
-
- -

При присвоении значения также возможно выполнение более одной операции. В этом случае переменной будет присвоено то значение, которое стоит последним в списке значений, разделенных запятой.

- -
var age = 16;
-
-var url = age > 18 ? (
-    alert("Хорошо, вы можете продолжить."),
-    // alert вернет "undefined", но это будет проигнорировано, потому что
-    // не является последним в списке значений, разделенных запятой
-    "continue.html" // значение будет присвоено, если age > 18
-) : (
-    alert("Вы слишком молоды!"),
-    alert("Простите :-("),
-    // ит.д. ит.д.
-    "stop.html" // значение будет присвоено, если !(age > 18)
-);
-
-location.assign(url); // "stop.html"
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES6', '#sec-conditional-operator', 'Условный Оператор')}}{{Spec2('ES6')}}
{{SpecName('ES5.1', '#sec-11.12', 'Условный оператор')}}{{Spec2('ES5.1')}}
{{SpecName('ES1', '#sec-11.12', 'Условный оператор')}}{{Spec2('ES1')}}Изначальное определение. Реализация в JavaScript 1.0.
- -

Поддержка браузерами

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
ОсобенностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ОсобенностьAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

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

- - diff --git a/files/ru/web/javascript/reference/statements/block/index.html b/files/ru/web/javascript/reference/statements/block/index.html new file mode 100644 index 0000000000..4122fea24d --- /dev/null +++ b/files/ru/web/javascript/reference/statements/block/index.html @@ -0,0 +1,177 @@ +--- +title: Блок +slug: Web/JavaScript/Reference/Statements/Блок +tags: + - JavaScript + - Инструкция + - Оператор + - справочник +translation_of: Web/JavaScript/Reference/Statements/block +--- +
{{jsSidebar("Statements")}}
+ +

Блок инструкций (или сложная инструкция в других языках) используется для группировки нуля или более инструкций. Блок отделяется парой фигурных скобок и может опционально быть {{jsxref("Statements/label", "поименован")}}:

+ +

Синтаксис

+ +
[имя:] {
+  инструкция_1;
+  инструкция_2;
+  ...
+  инструкция_n;
+}
+
+ +
+
инструкция_1, инструкция_2, инструкция_n
+
Инструкции, сгруппированные внутри блока инструкций.
+
имя
+
Необязательное {{jsxref("Statements/label", "имя")}} для визуальной идентификации или использования как точки выхода для оператора {{jsxref("Statements/break", "break")}}.
+
+ +

Описание

+ +

Эта инструкция широко используется с операторами управления потоком (н., {{jsxref("Statements/if...else", "if...else")}}, {{jsxref("Statements/for", "for")}}, {{jsxref("Statements/while", "while")}}). Например:

+ +
while (x < 10) {
+  x++;
+}
+
+ +

Обратите внимание, что блок инструкций не заканчивается точкой с запятой.

+ +

Блок инструкций часто называется сложной (составной) инструкцией в других языках. Он позволяет вам использовать несколько операторов там, где JavaScript ожидает один оператор. Помещение инструкций в блок - это распространенная практика в JavaScript. Противоположное поведение - использование пустого оператора там, где никаких действий не нужно, а оператор требуется.

+ +

Правила области видимости блока

+ +

С использованием var

+ +

Переменные, объявленные через var, не имеют блочной области видимости. Переменные, введенные внутри блока, имеют областью видимости содержащую их функцию или скрипт, и последствия записи в них значения распространяются за границы, собственно, блока, в котором они объявлены. Другими словами, блок инструкций не вводит новую область видимости. Хотя "отдельностоящие" блоки не являются нарушением синтаксиса, не стоит использовать отдельностоящие блоки в JavaScript, потому что они не делают то, чего вы от них ожидаете, если вы ожидаете, что они будут себя вести аналогично блокам в C или Java. Например:

+ +
var x = 1;
+{
+  var x = 2;
+}
+console.log(x); // выводит 2
+
+ +

Тут выводится 2, потому что оператор var x внутри блока - в той же области видимости, что и оператор var x перед блоком. В C или Java подобный код вывел бы 1.

+ +

С let и const

+ +

Наоборот, идентификаторы, объявленные с помощью {{jsxref("Statements/let", "let")}} и {{jsxref("Statements/const", "const")}} имеют блочную область видимости:

+ +
let x = 1;
+{
+  let x = 2;
+}
+console.log(x); // выводит 1
+ +

x = 2 ограничено рамками области видимости блока, в котором оно было определено.

+ +

То же самое и для const:

+ +
const c = 1;
+{
+  const c = 2;
+}
+console.log(c); // выводит 1 и не выбрасывает SyntaxError...
+ +

Обратите внимание, что объявленная внутри блока const c = 2 не кидает  SyntaxError: Identifier 'c' has already been declared (идентификатор 'c' уже был объявлен) потому что она может быть объявлена единожды внутри блока.

+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ESDraft', '#sec-block', 'Block statement')}}{{Spec2('ESDraft')}}
{{SpecName('ES6', '#sec-block', 'Block statement')}}{{Spec2('ES6')}}
{{SpecName('ES5.1', '#sec-12.1', 'Block statement')}}{{Spec2('ES5.1')}}
{{SpecName('ES3', '#sec-12.1', 'Block statement')}}{{Spec2('ES3')}}
{{SpecName('ES1', '#sec-12.1', 'Block statement')}}{{Spec2('ES1')}}Первоначальная редакция. Реализовано в JavaScript 1.0.
+ +

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

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
ВозможностьAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

См. так же

+ + diff --git a/files/ru/web/javascript/reference/statements/default/index.html b/files/ru/web/javascript/reference/statements/default/index.html deleted file mode 100644 index c1f3f6b923..0000000000 --- a/files/ru/web/javascript/reference/statements/default/index.html +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: default -slug: Web/JavaScript/Reference/Statements/default -tags: - - JavaScript - - Keyword - - Switch - - export -translation_of: Web/JavaScript/Reference/Statements/switch -translation_of_original: Web/JavaScript/Reference/Statements/default ---- -
{{jsSidebar("Statements")}}
- -

В JavaScript ключевое слово default используется в двух случаях: внутри конструкции {{jsxref("Statements/switch", "switch")}} или с конструкцией {{jsxref("Statements/export", "export")}}.

- -

Синтаксис

- -

В конструкции {{jsxref("Statements/switch", "switch")}}:

- -
switch (expression) {
-  case value1:
-    // Выражение выполнится, когда значение expression соответствует value1
-    [break;]
-  default:
-    // Выражение выполнится, когда ни одно из значений не будет соответствовать значению expression
-    [break;]
-}
- -

С конструкцией {{jsxref("Statements/export", "export")}}:

- -
export default nameN
- -

Описание

- -

Для получения дополнительной информации смотрите:

- - - -

Примеры

- -

Использование default в  switch

- -

В следующем примере, если expr имеет значение  "Апельсины" или "Яблоки", то программа сопоставит это значение с "Апельсины" или с "Яблоки", а затем выполнит соответствующее выражение. В других случаях поможет ключевое слово default,  выполня связанное выражение.

- -
switch (expr) {
-  case 'Апельсины':
-    console.log('Апельсины стоят $0.59 за фунт.');
-    break;
-  case 'Яблоки':
-    console.log('Яблоки стоят $0.32 за фунт.');
-    break;
-  default:
-    console.log(`Извините, у нас закончились ${expr}.`);
-}
- -

Использование default с export

- -

При необходимости экспорта единственного значения или резервирования (fallback) значения для модуля, можно воспользоваться экспортом по-умолчанию: 

- -
// модуль "my-module.js"
-let cube = function cube(x) {
-  return x * x * x;
-};
-export default cube;
- -

Тогда, в другом файле JavaScript, становится возможным просто импортировать экспортируемое по-умолчанию значение:

- -
// модуль "my-module.js"
-import myFunction from 'my-module';
-console.log(myFunction(3)); // 27
-
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES6', '#sec-switch-statement', 'switch statement')}}{{Spec2('ES6')}}
{{SpecName('ES6', '#sec-exports', 'Exports')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-switch-statement', 'switch statement')}}{{Spec2('ESDraft')}}
{{SpecName('ESDraft', '#sec-exports', 'Exports')}}{{Spec2('ESDraft')}}
- -

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

- -

{{Compat("javascript.statements.default")}}

- -

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

- - diff --git "a/files/ru/web/javascript/reference/statements/\320\261\320\273\320\276\320\272/index.html" "b/files/ru/web/javascript/reference/statements/\320\261\320\273\320\276\320\272/index.html" deleted file mode 100644 index 4122fea24d..0000000000 --- "a/files/ru/web/javascript/reference/statements/\320\261\320\273\320\276\320\272/index.html" +++ /dev/null @@ -1,177 +0,0 @@ ---- -title: Блок -slug: Web/JavaScript/Reference/Statements/Блок -tags: - - JavaScript - - Инструкция - - Оператор - - справочник -translation_of: Web/JavaScript/Reference/Statements/block ---- -
{{jsSidebar("Statements")}}
- -

Блок инструкций (или сложная инструкция в других языках) используется для группировки нуля или более инструкций. Блок отделяется парой фигурных скобок и может опционально быть {{jsxref("Statements/label", "поименован")}}:

- -

Синтаксис

- -
[имя:] {
-  инструкция_1;
-  инструкция_2;
-  ...
-  инструкция_n;
-}
-
- -
-
инструкция_1, инструкция_2, инструкция_n
-
Инструкции, сгруппированные внутри блока инструкций.
-
имя
-
Необязательное {{jsxref("Statements/label", "имя")}} для визуальной идентификации или использования как точки выхода для оператора {{jsxref("Statements/break", "break")}}.
-
- -

Описание

- -

Эта инструкция широко используется с операторами управления потоком (н., {{jsxref("Statements/if...else", "if...else")}}, {{jsxref("Statements/for", "for")}}, {{jsxref("Statements/while", "while")}}). Например:

- -
while (x < 10) {
-  x++;
-}
-
- -

Обратите внимание, что блок инструкций не заканчивается точкой с запятой.

- -

Блок инструкций часто называется сложной (составной) инструкцией в других языках. Он позволяет вам использовать несколько операторов там, где JavaScript ожидает один оператор. Помещение инструкций в блок - это распространенная практика в JavaScript. Противоположное поведение - использование пустого оператора там, где никаких действий не нужно, а оператор требуется.

- -

Правила области видимости блока

- -

С использованием var

- -

Переменные, объявленные через var, не имеют блочной области видимости. Переменные, введенные внутри блока, имеют областью видимости содержащую их функцию или скрипт, и последствия записи в них значения распространяются за границы, собственно, блока, в котором они объявлены. Другими словами, блок инструкций не вводит новую область видимости. Хотя "отдельностоящие" блоки не являются нарушением синтаксиса, не стоит использовать отдельностоящие блоки в JavaScript, потому что они не делают то, чего вы от них ожидаете, если вы ожидаете, что они будут себя вести аналогично блокам в C или Java. Например:

- -
var x = 1;
-{
-  var x = 2;
-}
-console.log(x); // выводит 2
-
- -

Тут выводится 2, потому что оператор var x внутри блока - в той же области видимости, что и оператор var x перед блоком. В C или Java подобный код вывел бы 1.

- -

С let и const

- -

Наоборот, идентификаторы, объявленные с помощью {{jsxref("Statements/let", "let")}} и {{jsxref("Statements/const", "const")}} имеют блочную область видимости:

- -
let x = 1;
-{
-  let x = 2;
-}
-console.log(x); // выводит 1
- -

x = 2 ограничено рамками области видимости блока, в котором оно было определено.

- -

То же самое и для const:

- -
const c = 1;
-{
-  const c = 2;
-}
-console.log(c); // выводит 1 и не выбрасывает SyntaxError...
- -

Обратите внимание, что объявленная внутри блока const c = 2 не кидает  SyntaxError: Identifier 'c' has already been declared (идентификатор 'c' уже был объявлен) потому что она может быть объявлена единожды внутри блока.

- -

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

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('ESDraft', '#sec-block', 'Block statement')}}{{Spec2('ESDraft')}}
{{SpecName('ES6', '#sec-block', 'Block statement')}}{{Spec2('ES6')}}
{{SpecName('ES5.1', '#sec-12.1', 'Block statement')}}{{Spec2('ES5.1')}}
{{SpecName('ES3', '#sec-12.1', 'Block statement')}}{{Spec2('ES3')}}
{{SpecName('ES1', '#sec-12.1', 'Block statement')}}{{Spec2('ES1')}}Первоначальная редакция. Реализовано в JavaScript 1.0.
- -

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

- -

{{CompatibilityTable}}

- -
- - - - - - - - - - - - - - - - - - - -
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -
- - - - - - - - - - - - - - - - - - - - - -
ВозможностьAndroidChrome for AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
-
- -

См. так же

- - diff --git a/files/ru/web/javascript/reference/template_literals/index.html b/files/ru/web/javascript/reference/template_literals/index.html new file mode 100644 index 0000000000..d8b4b9a442 --- /dev/null +++ b/files/ru/web/javascript/reference/template_literals/index.html @@ -0,0 +1,243 @@ +--- +title: Шаблонные строки +slug: Web/JavaScript/Reference/template_strings +tags: + - ECMAScript6 + - JavaScript + - Строки + - Шаблонные строки + - Экспериментальный +translation_of: Web/JavaScript/Reference/Template_literals +--- +
{{JsSidebar("More")}}
+ +
Шаблонными литералами называются строковые литералы, допускающие использование выражений внутри. С ними вы можете использовать многострочные литералы и строковую интерполяцию. В спецификациях до ES2015 они назывались "шаблонными строками".
+ +

Синтаксис

+ +
`строка текста`
+
+`строка текста 1
+ строка текста 2`
+
+`строка текста ${выражение} строка текста`
+
+tag `строка текста ${выражение} строка текста`
+
+ +

Описание

+ +

Шаблонные литералы заключены в обратные кавычки (` `) вместо двойных или одинарных. Они могут содержать подстановки, обозначаемые знаком доллара и фигурными скобками (${выражение}). Выражения в подстановках и текст между ними передаются в функцию. По умолчанию функция просто объединяет все части в строку. Если перед строкой есть выражение (здесь это tag), то шаблонная строка называется "теговым шаблоном". В этом случае, теговое выражение (обычно функция) вызывается с обработанным шаблонным литералом, который вы можете изменить перед выводом. Для экранирования обратной кавычки в шаблонных литералах указывается обратный слэш \.

+ +
`\`` === '`' // --> true
+ +

Многострочные литералы

+ +

Символы новой строки являются частью шаблонных литералов. Используя обычные строки, вставка переноса потребовала бы следующего синтаксиса:

+ +
console.log('string text line 1\n' +
+'string text line 2');
+// "string text line 1
+//  string text line 2"
+ +

То же с использованием шаблонных литералов:

+ +
console.log(`string text line 1
+string text line 2`);
+// "string text line 1
+//  string text line 2"
+ +

Интерполяция выражений

+ +

Для вставки выражений в обычные строки вам пришлось бы использовать следующий синтаксис:

+ +
var a = 5;
+var b = 10;
+console.log('Fifteen is ' + (a + b) + ' and not ' + (2 * a + b) + '.');
+// "Fifteen is 15 and not 20."
+ +

Теперь, при помощи шаблонных литералов, вам доступен "синтаксический сахар", делающий подстановки вроде той более читабельными:

+ +
var a = 5;
+var b = 10;
+console.log(`Fifteen is ${a + b} and not ${2 * a + b}.`);
+// "Fifteen is 15 and not 20."
+ +

Вложенные шаблоны

+ +

Временами, вложить шаблон — это кратчайший и, возможно, более читабельный способ составить строку. Просто поместите внутрь шаблона с обратными кавычками ещё одни, обернув их в подстановку ${ }. Например, если выражение истинно, можно вернуть шаблонный литерал.

+ +

В ES5:

+ +
var classes = 'header'
+classes += (isLargeScreen() ?
+   '' : item.isCollapsed ?
+     ' icon-expander' : ' icon-collapser');
+ +

В ES2015 с шаблонными литералами без вложения:

+ +
const classes = `header ${ isLargeScreen() ? '' :
+    (item.isCollapsed ? 'icon-expander' : 'icon-collapser') }`;
+
+ +

В ES2015 с вложенными шаблонными литералами:

+ +
const classes = `header ${ isLargeScreen() ? '' :
+`icon-${item.isCollapsed ? 'expander' : 'collapser'}` }`;
+
+ +

Теговые шаблоны

+ +

Расширенной формой шаблонных литералов являются теговые шаблоны. Они позволяют разбирать шаблонные литералы с помощью функции. Первый аргумент такой функции содержит массив строковых значений, а остальные содержат выражения из подстановок. В итоге, функция должна вернуть собранную строку (или что-либо совсем иное, как будет показано далее). Имя функции может быть любым.

+ +
var person = 'Mike';
+var age = 28;
+
+function myTag(strings, personExp, ageExp) {
+  var str0 = strings[0]; // "That "
+  var str1 = strings[1]; // " is a "
+
+  // Технически, в конце итогового выражения
+  // (в нашем примере) есть ещё одна строка,
+  // но она пустая (""), так что пропустим её.
+  // var str2 = strings[2];
+
+  var ageStr;
+  if (ageExp > 99){
+    ageStr = 'centenarian';
+  } else {
+    ageStr = 'youngster';
+  }
+
+  // Мы даже можем вернуть строку, построенную другим шаблонным литералом
+  return `${str0}${personExp}${str1}${ageStr}`;
+}
+
+var output = myTag`That ${ person } is a ${ age }`;
+
+console.log(output);
+// That Mike is a youngster
+ +

Функция тега не обязана возвращать строку, как показано в примере ниже:

+ +
function template(strings, ...keys) {
+  return (function(...values) {
+    var dict = values[values.length - 1] || {};
+    var result = [strings[0]];
+    keys.forEach(function(key, i) {
+      var value = Number.isInteger(key) ? values[key] : dict[key];
+      result.push(value, strings[i + 1]);
+    });
+    return result.join('');
+  });
+}
+
+var t1Closure = template`${0}${1}${0}!`;
+t1Closure('Y', 'A');  // "YAY!"
+var t2Closure = template`${0} ${'foo'}!`;
+t2Closure('Hello', {foo: 'World'});  // "Hello World!"
+
+ +

Сырые строки

+ +

Специальное свойство raw, доступное для первого аргумента тегового шаблона, позволяет получить строку в том виде, в каком она была введена, без экранирования.

+ +
function tag(strings) {
+  return strings.raw[0];
+}
+
+tag`string text line 1 \\n string text line 2`;
+// выводит "string text line 1 \\n string text line 2",
+// включая 'n' и два символа '\'
+
+ +

Вдобавок, существует метод {{jsxref('String.raw()')}}, возвращающий точно такую же исходную строку, какую вернула бы функция шаблона по умолчанию и строковая конкатенация вместе.

+ +
var str = String.raw`Hi\n${2+3}!`;
+// "Hi\n5!"
+
+str.length;
+// 6
+
+str.split('').join(',');
+// "H,i,\,n,5,!"
+ +

Теговые шаблоны и экранирование символов

+ +

Поведение в ES2016

+ +

В ECMAScript 2016 теговые шаблоны следуют правилам экранирования следующих символов:

+ + + +

Отсюда вытекает проблема теговых шаблонов: следуя грамматике ECMAScript, анализатор кода, найдя символ \, будет искать корректное представление символа Unicode, но может не найти его вовсе. Пример ниже показывает это:

+ +
latex`\unicode`
+// В старых версиях ECMAScript (ES2016 и раньше) выкинет исключение:
+// SyntaxError: malformed Unicode character escape sequence
+ +

Поведение в ES2018

+ +

Теговые шаблоны должны позволять встраивать языки (например, DSLs или LaTeX), в которых широко используются многие другие экранирования. Предложение Редакция шаблонных литералов (уровень 4, одобренный к добавлению в стандарт ECMAScript 2018) устраняет синтаксические ограничения экранирования теговых шаблонов в ECMAScript.

+ +

Однако, некорректное экранирование символов по-прежнему нужно отображать в "приготовленном" отображении. Оно показывается в виде {{jsxref("undefined")}} в "приготовленном" массиве:

+ +
function latex(str) {
+ return { "cooked": str[0], "raw": str.raw[0] }
+}
+
+latex`\unicode`
+
+// { cooked: undefined, raw: "\unicode" }
+ +

Заметьте, что ограничение на экранирование символов проявляется лишь в теговых шаблонах, и не проявляется в нетеговых шаблонных литералах:

+ +
let bad = `bad escape sequence: \unicode`;
+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-template-literals', 'Template Literals')}}{{Spec2('ES2015')}}Изначальное определение. Определено в секциях Template Literals, Tagged Templates
{{SpecName('ESDraft', '#sec-template-literals', 'Template Literals')}}{{Spec2('ESDraft')}}Определено в секциях Template Literals, Tagged Templates
Template Literal RevisionЧерновик 4-го уровняУстранено ограничение экранирования в теговых шаблонах
+ +

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

+ + + +

{{Compat("javascript.grammar.template_literals")}}

+ +

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

+ + diff --git a/files/ru/web/javascript/reference/template_strings/index.html b/files/ru/web/javascript/reference/template_strings/index.html deleted file mode 100644 index d8b4b9a442..0000000000 --- a/files/ru/web/javascript/reference/template_strings/index.html +++ /dev/null @@ -1,243 +0,0 @@ ---- -title: Шаблонные строки -slug: Web/JavaScript/Reference/template_strings -tags: - - ECMAScript6 - - JavaScript - - Строки - - Шаблонные строки - - Экспериментальный -translation_of: Web/JavaScript/Reference/Template_literals ---- -
{{JsSidebar("More")}}
- -
Шаблонными литералами называются строковые литералы, допускающие использование выражений внутри. С ними вы можете использовать многострочные литералы и строковую интерполяцию. В спецификациях до ES2015 они назывались "шаблонными строками".
- -

Синтаксис

- -
`строка текста`
-
-`строка текста 1
- строка текста 2`
-
-`строка текста ${выражение} строка текста`
-
-tag `строка текста ${выражение} строка текста`
-
- -

Описание

- -

Шаблонные литералы заключены в обратные кавычки (` `) вместо двойных или одинарных. Они могут содержать подстановки, обозначаемые знаком доллара и фигурными скобками (${выражение}). Выражения в подстановках и текст между ними передаются в функцию. По умолчанию функция просто объединяет все части в строку. Если перед строкой есть выражение (здесь это tag), то шаблонная строка называется "теговым шаблоном". В этом случае, теговое выражение (обычно функция) вызывается с обработанным шаблонным литералом, который вы можете изменить перед выводом. Для экранирования обратной кавычки в шаблонных литералах указывается обратный слэш \.

- -
`\`` === '`' // --> true
- -

Многострочные литералы

- -

Символы новой строки являются частью шаблонных литералов. Используя обычные строки, вставка переноса потребовала бы следующего синтаксиса:

- -
console.log('string text line 1\n' +
-'string text line 2');
-// "string text line 1
-//  string text line 2"
- -

То же с использованием шаблонных литералов:

- -
console.log(`string text line 1
-string text line 2`);
-// "string text line 1
-//  string text line 2"
- -

Интерполяция выражений

- -

Для вставки выражений в обычные строки вам пришлось бы использовать следующий синтаксис:

- -
var a = 5;
-var b = 10;
-console.log('Fifteen is ' + (a + b) + ' and not ' + (2 * a + b) + '.');
-// "Fifteen is 15 and not 20."
- -

Теперь, при помощи шаблонных литералов, вам доступен "синтаксический сахар", делающий подстановки вроде той более читабельными:

- -
var a = 5;
-var b = 10;
-console.log(`Fifteen is ${a + b} and not ${2 * a + b}.`);
-// "Fifteen is 15 and not 20."
- -

Вложенные шаблоны

- -

Временами, вложить шаблон — это кратчайший и, возможно, более читабельный способ составить строку. Просто поместите внутрь шаблона с обратными кавычками ещё одни, обернув их в подстановку ${ }. Например, если выражение истинно, можно вернуть шаблонный литерал.

- -

В ES5:

- -
var classes = 'header'
-classes += (isLargeScreen() ?
-   '' : item.isCollapsed ?
-     ' icon-expander' : ' icon-collapser');
- -

В ES2015 с шаблонными литералами без вложения:

- -
const classes = `header ${ isLargeScreen() ? '' :
-    (item.isCollapsed ? 'icon-expander' : 'icon-collapser') }`;
-
- -

В ES2015 с вложенными шаблонными литералами:

- -
const classes = `header ${ isLargeScreen() ? '' :
-`icon-${item.isCollapsed ? 'expander' : 'collapser'}` }`;
-
- -

Теговые шаблоны

- -

Расширенной формой шаблонных литералов являются теговые шаблоны. Они позволяют разбирать шаблонные литералы с помощью функции. Первый аргумент такой функции содержит массив строковых значений, а остальные содержат выражения из подстановок. В итоге, функция должна вернуть собранную строку (или что-либо совсем иное, как будет показано далее). Имя функции может быть любым.

- -
var person = 'Mike';
-var age = 28;
-
-function myTag(strings, personExp, ageExp) {
-  var str0 = strings[0]; // "That "
-  var str1 = strings[1]; // " is a "
-
-  // Технически, в конце итогового выражения
-  // (в нашем примере) есть ещё одна строка,
-  // но она пустая (""), так что пропустим её.
-  // var str2 = strings[2];
-
-  var ageStr;
-  if (ageExp > 99){
-    ageStr = 'centenarian';
-  } else {
-    ageStr = 'youngster';
-  }
-
-  // Мы даже можем вернуть строку, построенную другим шаблонным литералом
-  return `${str0}${personExp}${str1}${ageStr}`;
-}
-
-var output = myTag`That ${ person } is a ${ age }`;
-
-console.log(output);
-// That Mike is a youngster
- -

Функция тега не обязана возвращать строку, как показано в примере ниже:

- -
function template(strings, ...keys) {
-  return (function(...values) {
-    var dict = values[values.length - 1] || {};
-    var result = [strings[0]];
-    keys.forEach(function(key, i) {
-      var value = Number.isInteger(key) ? values[key] : dict[key];
-      result.push(value, strings[i + 1]);
-    });
-    return result.join('');
-  });
-}
-
-var t1Closure = template`${0}${1}${0}!`;
-t1Closure('Y', 'A');  // "YAY!"
-var t2Closure = template`${0} ${'foo'}!`;
-t2Closure('Hello', {foo: 'World'});  // "Hello World!"
-
- -

Сырые строки

- -

Специальное свойство raw, доступное для первого аргумента тегового шаблона, позволяет получить строку в том виде, в каком она была введена, без экранирования.

- -
function tag(strings) {
-  return strings.raw[0];
-}
-
-tag`string text line 1 \\n string text line 2`;
-// выводит "string text line 1 \\n string text line 2",
-// включая 'n' и два символа '\'
-
- -

Вдобавок, существует метод {{jsxref('String.raw()')}}, возвращающий точно такую же исходную строку, какую вернула бы функция шаблона по умолчанию и строковая конкатенация вместе.

- -
var str = String.raw`Hi\n${2+3}!`;
-// "Hi\n5!"
-
-str.length;
-// 6
-
-str.split('').join(',');
-// "H,i,\,n,5,!"
- -

Теговые шаблоны и экранирование символов

- -

Поведение в ES2016

- -

В ECMAScript 2016 теговые шаблоны следуют правилам экранирования следующих символов:

- - - -

Отсюда вытекает проблема теговых шаблонов: следуя грамматике ECMAScript, анализатор кода, найдя символ \, будет искать корректное представление символа Unicode, но может не найти его вовсе. Пример ниже показывает это:

- -
latex`\unicode`
-// В старых версиях ECMAScript (ES2016 и раньше) выкинет исключение:
-// SyntaxError: malformed Unicode character escape sequence
- -

Поведение в ES2018

- -

Теговые шаблоны должны позволять встраивать языки (например, DSLs или LaTeX), в которых широко используются многие другие экранирования. Предложение Редакция шаблонных литералов (уровень 4, одобренный к добавлению в стандарт ECMAScript 2018) устраняет синтаксические ограничения экранирования теговых шаблонов в ECMAScript.

- -

Однако, некорректное экранирование символов по-прежнему нужно отображать в "приготовленном" отображении. Оно показывается в виде {{jsxref("undefined")}} в "приготовленном" массиве:

- -
function latex(str) {
- return { "cooked": str[0], "raw": str.raw[0] }
-}
-
-latex`\unicode`
-
-// { cooked: undefined, raw: "\unicode" }
- -

Заметьте, что ограничение на экранирование символов проявляется лишь в теговых шаблонах, и не проявляется в нетеговых шаблонных литералах:

- -
let bad = `bad escape sequence: \unicode`;
- -

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

- - - - - - - - - - - - - - - - - - - - - - - - -
СпецификацияСтатусКомментарий
{{SpecName('ES2015', '#sec-template-literals', 'Template Literals')}}{{Spec2('ES2015')}}Изначальное определение. Определено в секциях Template Literals, Tagged Templates
{{SpecName('ESDraft', '#sec-template-literals', 'Template Literals')}}{{Spec2('ESDraft')}}Определено в секциях Template Literals, Tagged Templates
Template Literal RevisionЧерновик 4-го уровняУстранено ограничение экранирования в теговых шаблонах
- -

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

- - - -

{{Compat("javascript.grammar.template_literals")}}

- -

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

- - diff --git "a/files/ru/web/javascript/reference/\320\276\320\261/index.html" "b/files/ru/web/javascript/reference/\320\276\320\261/index.html" deleted file mode 100644 index bbb30f131d..0000000000 --- "a/files/ru/web/javascript/reference/\320\276\320\261/index.html" +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Об этой справке -slug: Web/JavaScript/Reference/Об -translation_of: Web/JavaScript/Reference/About ---- -
{{JsSidebar}}
- -

The JavaScript reference serves as a repository of facts about the JavaScript language. The entire language is described here in detail. As you write JavaScript code, you'll refer to these pages often (thus the title "JavaScript reference"). If you're learning JavaScript, or need help understanding some of its capabilities or features, check out the JavaScript guide.

- -

The JavaScript language is intended to be used within some larger environment, be it a browser, server-side scripts, or similar. For the most part, this reference attempts to be environment-agnostic and does not target a web browser environment.

- -

Where to find JavaScript information

- -

JavaScript documentation of core language features (pure ECMAScript, for the most part) includes the following:

- - - -

If you are new to JavaScript, start with the guide. Once you have a firm grasp of the fundamentals, you can use the reference to get more details on individual objects and language constructs.

- -

Structure of the reference

- -

In the JavaScript reference you can find the following chapters:

- -
-
Standard built-in objects
-
This chapter documents all the JavaScript standard built-in objects, along with their methods and properties.
-
Statements and declarations
-
JavaScript applications consist of statements with an appropriate syntax. A single statement may span multiple lines. Multiple statements may occur on a single line if each statement is separated by a semicolon. This isn't a keyword, but a group of keywords.
-
Expressions and operators
-
This chapter documents all the JavaScript language operators, expressions and keywords.
-
Functions
-
Chapter about JavaScript functions.
-
Classes
-
Chapter about JavaScript classes introduced in ECMAScript 6.
-
Errors
-
Chapter about specific errors, exceptions and warnings thrown by JavaScript.
-
New in JavaScript
-
Chapter about JavaScript version history.
-
- -

More reference pages

- - diff --git a/files/ru/web/javascript/shells/index.html b/files/ru/web/javascript/shells/index.html new file mode 100644 index 0000000000..b6e3421b96 --- /dev/null +++ b/files/ru/web/javascript/shells/index.html @@ -0,0 +1,44 @@ +--- +title: JavaScript оболочки +slug: Web/JavaScript/JavaScript_шеллы +translation_of: Web/JavaScript/Shells +--- +
{{JsSidebar}}
+ +

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

+ +

Автономные JavaScript оболочки

+ +

Следующие JavaScript шеллы являются автономными средами, как Perl или Python.

+ + + +

Список JavaScript оболочек

+ +

Следующие JavaScript оболочки работают с Mozilla.

+ + diff --git "a/files/ru/web/javascript/\320\276_javascript/index.html" "b/files/ru/web/javascript/\320\276_javascript/index.html" deleted file mode 100644 index 6d3682cf3a..0000000000 --- "a/files/ru/web/javascript/\320\276_javascript/index.html" +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: О JavaScript -slug: Web/JavaScript/О_JavaScript -tags: - - Beginner - - Introduction - - JavaScript - - Вступление - - Новичку -translation_of: Web/JavaScript/About_JavaScript ---- -

{{JsSidebar()}}

- -

Что такое JavaScript?

- -

JavaScript® (часто сокращают до JS) — это лёгкий, интерпретируемый, объектно-ориентированный язык с функциями первого класса, самый известный скриптовый язык для веб-страниц, но также используется во многих не браузерных окружениях. Прототипно-ориентированный, мультипарадигменный язык сценариев, который поддерживает динамический, объектно-ориентированный, императивный и функциональный стили программирования.

- -

JavaScript запускается на стороне клиента Интернета, который может использоваться для создания/программирования того, как веб-страницы будут вести себя при наступлении каких-либо событий. JavaScript легко изучить, а также это мощный скриптовый язык, широко используемый для контролирования поведения веб-страниц.

- -

Вопреки распространенному мнению, JavaScript не является "интерпретируемым Java". В двух словах, JavaScript — это динамический скриптовый язык, поддерживающий прототипное создание объектов. Базовый синтаксис намеренно похож на Java и C++, чтобы уменьшить число новых концепций, необходимых для изучения языка. Такие языковые конструкции, как if, for, while, switch, try ... catch похожи на конструкции этих языков.

- -

JavaScript может функционировать и как процедурный, и как объектно-ориентированный язык. Объекты можно создавать программно во время выполнения, путем присоединения методов и свойств или пустых объектов во время выполнения, в отличие от синтаксических определений классов в компилируемых языках, таких как С++ или Java. После того, как объект был создан, он может быть использован в качестве плана (или прототипа) для создания похожих объектов.

- -

Динамические возможности JavaScript включают: создание объектов во время выполнения, переменное число параметров, динамическое создание скриптов (с помощью eval), перебор объектов (с помощью for ... in), восстановление исходного кода (программы на JavaScript могут декомпилировать тела функций обратно в исходный код).

- -

Для более глубокого погружения в программирование на JavaScript, используйте ссылки ниже в разделе Ресурсы по JavaScript.

- -

Какие реализации JavaScript доступны?

- -

Mozilla предоставляет две реализации JavaScript. Самая первая реализация JavaScript была создана Бренданом Эйхом (Brendan Eich) в компании Netscape, и с тех пор обновляется, чтобы соответствовать ECMA-262 Edition 5 и более поздним версиям. Этот движок называется SpiderMonkey и реализован на языке C/C++. Движок Rhino создан Норрисом Бойдом (Norris Boyd) и реализован на языке Java. Как и SpiderMonkey, Rhino соответствует ECMA-262 Edition 5.

- -

Несколько оптимизаций, таких как TraceMonkey (Firefox 3.5), JägerMonkey (Firefox 4) и IonMonkey, добавили в SpiderMonkey со временем. Работа всегда продолжается, чтобы улучшить производительность выполнения JavaScript.

- -

Кроме вышеприведенных существуют и другие популярные реализации:

- - - -

Каждый движок mozilla.org предоставляет публичный API, который могут использовать разработчики приложений для интеграции JavaScript в своё ПО. Однако, наиболее распространенной средой для JavaScript являются веб-браузеры. Веб-браузеры обычно используют публичный API для создания объектов среды, отражающих DOM в JavaScript.

- -

JavaScript также применяется как скриптовый язык на стороне сервера. JavaScript сервер предоставляет объекты среды, представляющие объекты HTTP запросов и ответов, которые могут быть использованы программой на JavaScript для динамической генерации веб-страниц. Популярным примером является Node.js.

- -

Ресурсы по JavaScript

- -
-
SpiderMonkey
-
SpiderMonkey — это интерпретатор языка JavaScript, написанный на языке C. Информация, относящаяся к реализации движка JavaScript Mozilla на C/C++ (aka SpiderMonkey), включая, как вставлять его в приложения.
-
Rhino
-
Информация, относящаяся к реализации JavaScript, написанной на Java (aka Rhino).
-
Ресурсы по языку
-
Ссылки на опубликованные стандарты по JavaScript.
-
Повторное введение в JavaScript
-
Руководство и справочник по JavaScript.
-
- -

JavaScript® - торговая марка или зарегистрированная торговая марка Oracle в США и других странах.

-- cgit v1.2.3-54-g00ecf