diff options
Diffstat (limited to 'files/ru/web/javascript')
13 files changed, 68 insertions, 68 deletions
diff --git a/files/ru/web/javascript/guide/control_flow_and_error_handling/index.html b/files/ru/web/javascript/guide/control_flow_and_error_handling/index.html index dd86463b4a..b2b7191228 100644 --- a/files/ru/web/javascript/guide/control_flow_and_error_handling/index.html +++ b/files/ru/web/javascript/guide/control_flow_and_error_handling/index.html @@ -339,7 +339,7 @@ catch (e) { <li><em>ожидание (pending)</em>: начальное состояние, не выполнено и не отклонено.</li> <li><em>выполнено (fulfilled)</em>: операция завершена успешно.</li> <li><em>отклонено (rejected)</em>: операция завершена с ошибкой.</li> - <li><em>заданный (settled)</em>: обещание выполнено или отклонено, но не находится в состоянии ожидания.</li> + <li><em>заданный (settled)</em>: промис выполнен или отклонен, но не находится в состоянии ожидания.</li> </ul> <p><img alt="" src="https://mdn.mozillademos.org/files/8633/promises.png" style="height: 297px; width: 801px;"></p> diff --git a/files/ru/web/javascript/guide/using_promises/index.html b/files/ru/web/javascript/guide/using_promises/index.html index 7793197399..90c0214d0c 100644 --- a/files/ru/web/javascript/guide/using_promises/index.html +++ b/files/ru/web/javascript/guide/using_promises/index.html @@ -13,7 +13,7 @@ original_slug: Web/JavaScript/Guide/Ispolzovanie_promisov <p>{{jsSidebar("Руководство по JavaScript")}}{{PreviousNext("Web/JavaScript/Guide/Details_of_the_Object_Model", "Web/JavaScript/Guide/Iterators_and_Generators")}}</p> </div> -<p class="summary">{{jsxref("Promise")}} (промис, англ. "обещание") - это объект, представляющий результат успешного или неудачного завершения асинхронной операции. Так как большинство людей пользуются уже созданными промисами, это руководство начнём с объяснения использования вернувшихся промисов до объяснения принципов создания. </p> +<p class="summary">{{jsxref("Promise")}} (промис) - это объект, представляющий результат успешного или неудачного завершения асинхронной операции. Так как большинство людей пользуются уже созданными промисами, это руководство начнём с объяснения использования вернувшихся промисов до объяснения принципов создания. </p> <p>В сущности, промис - это возвращаемый объект, в который вы записываете два колбэка вместо того, чтобы передать их функции.</p> @@ -281,23 +281,23 @@ console.log(1); // 1, 2, 3, 4</code></pre> <h2 id="Частые_ошибки">Частые ошибки</h2> -<p>В этом разделе собраны частые ошибки, возникающие при создании цепочек обещаний. Несколько таких ошибок можно увидеть в следующем примере:</p> +<p>В этом разделе собраны частые ошибки, возникающие при создании цепочек промисов. Несколько таких ошибок можно увидеть в следующем примере:</p> <pre><code>// Плохой пример! Три ошибки! doSomething().then(function(result) { - doSomethingElse(result) // Забыл вернуть обещание из внутренней цепочки + неуместное влаживание + doSomethingElse(result) // Забыл вернуть промис из внутренней цепочки + неуместное влаживание .then(newResult => doThirdThing(newResult)); }).then(() => doFourthThing()); // Забыл закончить цепочку методом catch</code></pre> <p>Первая ошибка это неправильно сцепить вещи между собой. Такое происходит когда мы создаём промис но забываем вернуть его. Как следствие, цепочка сломана, но правильнее было бы сказать что теперь у нас есть две независимые цепочки, соревнующиеся за право разрешится первой. Это означает <code>doFourthThing()</code> не будет ждать <code>doSomethingElse()</code> или <code>doThirdThing()</code> пока тот закончится, и будет исполнятся параллельно с ними, это ,вероятно, не то что хотел разработчик. Отдельные цепочки также имеют отдельную обработку ошибок, что приводит к необработанным ошибкам.</p> -<p>Вторая ошибка это излишняя вложенность, включая первую ошибку. Вложенность также ограничивает область видимости внутренних обработчиков ошибок, если это не то чего хотел разработчик, это может привести к необработанным ошибкам. Примером этого является <a href="https://stackoverflow.com/questions/23803743/what-is-the-explicit-promise-construction-antipattern-and-how-do-i-avoid-it">пример как не нужно создавать обещания</a>, который комбинирует вложенность с чрезмерным использованием конструктора обещаний для оборачивания кода который уже использует промисы.</p> +<p>Вторая ошибка это излишняя вложенность, включая первую ошибку. Вложенность также ограничивает область видимости внутренних обработчиков ошибок, если это не то чего хотел разработчик, это может привести к необработанным ошибкам. Примером этого является <a href="https://stackoverflow.com/questions/23803743/what-is-the-explicit-promise-construction-antipattern-and-how-do-i-avoid-it">пример как не нужно создавать промисы</a>, который комбинирует вложенность с чрезмерным использованием конструктора промисов для оборачивания кода который уже использует промисы.</p> -<p>Третья ошибка это забыть закончить цепочку ключевым словом <code>catch</code>. Незаконченные цепочки приводят к необработанным отторжениям обещаний в большинстве браузеров.</p> +<p>Третья ошибка это забыть закончить цепочку ключевым словом <code>catch</code>. Незаконченные цепочки приводят к необработанным отторжениям промисов в большинстве браузеров.</p> -<p>Хорошим примером является всегда либо возвращать либо заканчивать цепочки обещаний, и как только вы получаете новое обещание, возвращайте его сразу же, чтобы не усложнять код излишней вложенностью:</p> +<p>Хорошим примером является всегда либо возвращать либо заканчивать цепочки промисов, и как только вы получаете новый промис, возвращайте его сразу же, чтобы не усложнять код излишней вложенностью:</p> <pre><code>doSomething() .then(function(result) { diff --git a/files/ru/web/javascript/reference/errors/not_a_constructor/index.html b/files/ru/web/javascript/reference/errors/not_a_constructor/index.html index 6dd7c11364..cc7a5e3150 100644 --- a/files/ru/web/javascript/reference/errors/not_a_constructor/index.html +++ b/files/ru/web/javascript/reference/errors/not_a_constructor/index.html @@ -69,11 +69,11 @@ var obj = new f; <pre class="brush: js">var mycar = new Car('Лада', 'Самара', 1993);</pre> -<h3 id="В_Обещаниях_(Promises)">В Обещаниях (Promises)</h3> +<h3 id="В_Промисах">В Промисах</h3> -<p>В случае, когда возвращается незамедлительно разрешённое или незамедлительно отклонённое Обещание, вам не нужно создавать новое Обещание <em>new Promise(...)</em> и работать с ним.</p> +<p>В случае, когда возвращается незамедлительно разрешённый или незамедлительно отклонённый промис, вам не нужно создавать новый промис <em>new Promise(...)</em> и работать с ним.</p> -<p>Это неправильно (<a href="/en-US/docs/Mozilla/JavaScript_code_modules/Promise.jsm/Promise#Constructor">конструктор Обещания</a> вызывается неправильно) и будет вызывать исключение <code>TypeError: this is not a constructor</code>:</p> +<p>Это неправильно (<a href="/en-US/docs/Mozilla/JavaScript_code_modules/Promise.jsm/Promise#Constructor">конструктор Promise</a> вызывается неправильно) и будет вызывать исключение <code>TypeError: this is not a constructor</code>:</p> <pre class="brush: js example-bad">return new Promise.resolve(true); </pre> diff --git a/files/ru/web/javascript/reference/global_objects/promise/all/index.html b/files/ru/web/javascript/reference/global_objects/promise/all/index.html index 44ef0a5cf7..e6e344a440 100644 --- a/files/ru/web/javascript/reference/global_objects/promise/all/index.html +++ b/files/ru/web/javascript/reference/global_objects/promise/all/index.html @@ -4,7 +4,7 @@ slug: Web/JavaScript/Reference/Global_Objects/Promise/all tags: - ECMAScript6 - JavaScript - - Обещание + - Промис - метод translation_of: Web/JavaScript/Reference/Global_Objects/Promise/all --- @@ -12,7 +12,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise/all <h2 id="Summary" name="Summary">Общее описание</h2> -<p>Метод <code><strong>Promise.all(iterable)</strong></code> возвращает обещание, которое выполнится тогда, когда будут выполнены все обещания, переданные в виде перечисляемого аргумента, или отклонено любое из переданных обещаний.</p> +<p>Метод <code><strong>Promise.all(iterable)</strong></code> возвращает промис, который выполнится тогда, когда будут выполнены все промисы, переданные в виде перечисляемого аргумента, или отклонено любое из переданных промисов.</p> <h2 id="Syntax" name="Syntax">Синтаксис</h2> @@ -27,19 +27,19 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise/all <h3 id="Возвращаемое_значение">Возвращаемое значение</h3> -<p>{{jsxref("Promise")}}, который будет выполнен когда будут выполнены все обещания, переданные в виде перечисляемого аргумента, или отклонён, если будет отклонено хоть одно из переданных обещаний.</p> +<p>{{jsxref("Promise")}}, который будет выполнен когда будут выполнены все промисы, переданные в виде перечисляемого аргумента, или отклонён, если будет отклонено хоть одно из переданных промисов.</p> <h2 id="Description" name="Description">Описание</h2> -<p><strong>Promise.all</strong> возвращает массив значений от всех обещаний, которые были ему переданы. Возвращаемый массив значений сохраняет порядок оригинального перечисляемого объекта, но не порядок выполнения обещаний. <code>Если какой-либо элемент перечисляемого объекта не является обещанием, то он будет преобразован с помощью метода </code>{{jsxref("Promise.resolve")}}<code>.</code></p> +<p><strong>Promise.all</strong> возвращает массив значений от всех промисов, которые были ему переданы. Возвращаемый массив значений сохраняет порядок оригинального перечисляемого объекта, но не порядок выполнения промисов. <code>Если какой-либо элемент перечисляемого объекта не является промисом, то он будет преобразован с помощью метода </code>{{jsxref("Promise.resolve")}}<code>.</code></p> -<p>Если одно из переданных обещаний будет отклонено, <code><strong>Promise.all </strong></code>будет немедленно отклонён со значением отклонённого обещания, не учитывая другие обещания, независимо выполнены они или нет. Если в качестве аргумента будет передан пустой массив, то <code><strong>Promise.all</strong> </code>будет выполнен немедленно<code>. </code></p> +<p>Если одно из переданных промисов будет отклонено, <code><strong>Promise.all </strong></code>будет немедленно отклонён со значением отклонённого промиса, не учитывая другие промисы, независимо выполнены они или нет. Если в качестве аргумента будет передан пустой массив, то <code><strong>Promise.all</strong> </code>будет выполнен немедленно<code>. </code></p> <h2 id="Примеры">Примеры</h2> <h3 id="Использование_Promise.all">Использование <code>Promise.all</code></h3> -<p><strong>Promise.all </strong>ждёт выполнения всех обещаний (или первого метода <code><strong>reject</strong>()</code>).</p> +<p><strong>Promise.all</strong> ждёт выполнения всех промисов (или первого метода <code><strong>reject</strong>()</code>).</p> <pre><code>var p1 = Promise.resolve(3); var p2 = 1337; @@ -57,7 +57,7 @@ Promise.all([p1, p2, p3]).then(values => { <h3 id="Promise.all_поведение_немедленного_отклонения"><code>Promise.all</code> поведение немедленного отклонения</h3> -<p><strong><code>Promise.all</code></strong> будет немедленно отклонён если одно из переданных обещаний будет отклонено: если у вас есть четыре обещания которые будут выполнены с задержкой и одно, которое будет отклонено немедленно - тогда <strong><code>Promise.all</code></strong> будет немедленно отклонён.</p> +<p><strong><code>Promise.all</code></strong> будет немедленно отклонён если один из переданных промисов будет отклонен: если у вас есть четыре промиса которые будут выполнены с задержкой и один, который будет отклонен немедленно - тогда <strong><code>Promise.all</code></strong> будет немедленно отклонён.</p> <pre><code>var p1 = new Promise((resolve, reject) => { setTimeout(resolve, 1000, "one"); @@ -72,7 +72,7 @@ var p4 = new Promise((resolve, reject) => { setTimeout(resolve, 4000, "four"); }); var p5 = new Promise((resolve, reject) => { -// Это обещание прервёт Promise.all +// Этот промис прервёт Promise.all reject("reject"); }); diff --git a/files/ru/web/javascript/reference/global_objects/promise/any/index.html b/files/ru/web/javascript/reference/global_objects/promise/any/index.html index fc85e0927c..9216e7496e 100644 --- a/files/ru/web/javascript/reference/global_objects/promise/any/index.html +++ b/files/ru/web/javascript/reference/global_objects/promise/any/index.html @@ -5,7 +5,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise/any --- <div>{{JSRef}}</div> -<p><code>Метод Promise.any()</code> принимает итерируемый объект содержащий объекты "обещаний" {{JSxRef("Promise")}}. Как только одно из "обещаний"(<code>Promise)</code> выполнится успешно(<code>fullfill</code>), метод возвратит единственный объект <code>Promise</code> со значением выполненного "обещания". Если ни одно из "обещаний" не завершится успешно(если все "обещания" завершатся с ошибкой, т.е. <code>rejected</code>), тогда возвращённый объект promise будет отклонён(<code>rejected</code>) с одним из значений: массив содержащий причины ошибки(отклонения), или {{JSxRef("AggregateError")}} — подкласс {{JSxRef("Error")}}, который объединяет выброшенные ошибки вместе. По существу, метод <code>Promise.any()</code> является противоположностью для {{JSxRef("Promise.all()")}}.</p> +<p><code>Метод Promise.any()</code> принимает итерируемый объект содержащий объекты промисов {{JSxRef("Promise")}}. Как только один из промисов (<code>Promise)</code> выполнится успешно (<code>fullfill</code>), метод возвратит единственный объект <code>Promise</code> со значением выполненного промиса. Если ни один из промисов не завершится успешно (если все промисы завершатся с ошибкой, т.е. <code>rejected</code>), тогда возвращённый объект Promise будет отклонён (<code>rejected</code>) с одним из значений: массив содержащий причины ошибки (отклонения), или {{JSxRef("AggregateError")}} — подкласс {{JSxRef("Error")}}, который объединяет выброшенные ошибки вместе. По существу, метод <code>Promise.any()</code> является противоположностью для {{JSxRef("Promise.all()")}}.</p> <div class="blockIndicator warning"> <p><strong>Warning!</strong> The <code>Promise.any()</code> method is experimental and not fully supported by all browsers. It is currently in the <a href="https://github.com/tc39/proposal-promise-any" rel="external">TC39 Candidate stage (Stage 3)</a>.</p> @@ -26,29 +26,29 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise/any <ul> <li><strong>Исполненный</strong> {{JSxRef("Promise")}}, если переданный итерируемый объект пуст.</li> - <li><strong>Исполненный асинхронно</strong> {{JSxRef("Promise")}}, если переданный итерируемый объект не содержит "обещаний"(promises).</li> - <li>Во всех других случаях {{JSxRef("Promise")}} со статусом ожидания(<strong>pending)</strong>. Возвращённое "обещание" будет <strong>исполнено</strong>(resolved/rejected) <strong>асинхронно</strong> (как только стэк вызовов окажется пустым), когда одно(любое) "обещание" из <em>переданного итерируемого объекта исполнится</em>, либо все "обещания" будут отклонены.</li> + <li><strong>Исполненный асинхронно</strong> {{JSxRef("Promise")}}, если переданный итерируемый объект не содержит промисов.</li> + <li>Во всех других случаях {{JSxRef("Promise")}} со статусом ожидания(<strong>pending)</strong>. Возвращённый промис будет <strong>исполнен</strong>(resolved/rejected) <strong>асинхронно</strong> (как только стэк вызовов окажется пустым), когда один (любой) промис из <em>переданного итерируемого объекта исполнится</em>, либо все промисы будут отклонены.</li> </ul> <h2 id="Описание">Описание</h2> -<p>Метод полезен, когда нужно вернуть первое исполненное "обещание". После того как одно из "обещаний" будет исполнено, метод не будет дожидаться исполнения остальных. В отличие от {{JSxRef("Promise.all()")}}, который содержит <em>массив(Array)</em> значений исполненных обещаний, <code>Promise.any()</code> содержит только одно значение (при условии, что хотя бы одно из "обещаний" исполнено успешно). Такой подход может быть выгодным, когда нужно, чтобы выполнилось только одно "обещание", неважно какое. Также, в отличие от {{JSxRef("Promise.race()")}}, который возвращает "обещание", содержащее значение первого <strong>завершённого(resolved или rejected)</strong>, этот метод возвращает "обещание" содержащее значение первого <strong>успешно выполненного(resolved) </strong>"обещания". Метод будет игнорировать исполнение обещаний с ошибкой(rejection) вплоть до первого исполненного успешно(fullfilment).</p> +<p>Метод полезен, когда нужно вернуть первый исполненный промис. После того как один из промисов будет исполнен, метод не будет дожидаться исполнения остальных. В отличие от {{JSxRef("Promise.all()")}}, который содержит <em>массив(Array)</em> значений исполненных промисов, <code>Promise.any()</code> содержит только одно значение (при условии, что хотя бы один из промисов исполнен успешно). Такой подход может быть выгодным, когда нужно, чтобы выполнился только один промис, неважно какой. Также, в отличие от {{JSxRef("Promise.race()")}}, который возвращает промис, содержащий значение первого <strong>завершённого(resolved или rejected)</strong>, этот метод возвращает промис содержащее значение первого <strong>успешно выполненного(resolved)</strong> промиса. Метод будет игнорировать исполнение промисов с ошибкой(rejection) вплоть до первого исполненного успешно (fullfilment).</p> <h3 id="Успешное_исполнениеFullfilment">Успешное исполнение(Fullfilment)</h3> -<p>Если одно из "обещаний" исполнится успешно, возвращённое "обещание" асинхронно исполнится успешно со значением выполненного "обещания", независимо от завершения остальных "обещаний".</p> +<p>Если один из промисов исполнится успешно, возвращённый промис асинхронно исполнится успешно со значением выполненного промиса, независимо от завершения остальных промисов.</p> <ul> - <li>Если передан пустой итерируемый объект, тогда метод возвращает (синхронно) выполненное "обещание".</li> - <li>Если одно из переданных обещаний исполнится успешно, или в переданном итерируемом объекте не содержится "обещаний", "обещание" возвращённое из метода <code>Promise.any</code> асинхронно исполнится успешно.</li> + <li>Если передан пустой итерируемый объект, тогда метод возвращает (синхронно) выполненный промис.</li> + <li>Если один из переданных промисов исполнится успешно, или в переданном итерируемом объекте не содержится промисов, промис возвращённый из метода <code>Promise.any</code> асинхронно исполнится успешно.</li> </ul> <h3 id="Исполнение_с_ошибкойRejection">Исполнение с ошибкой(Rejection)</h3> -<p>Если все переданные "обещания" будут отклонены(rejected), <code>Promise.any</code> асинхронно будет отклонено в одном из двух вариантов (которые ещё не были согласованы): либо</p> +<p>Если все переданные промисы будут отклонены (rejected), <code>Promise.any</code> асинхронно будет отклонено в одном из двух вариантов (которые ещё не были согласованы): либо</p> <ul> - <li>Массив(Array) содержащий причины отклонения всех "обещаний" переданных в итерируемом объекте, либо</li> + <li>Массив(Array) содержащий причины отклонения всех промисов переданных в итерируемом объекте, либо</li> <li>Объект {{JSxRef("AggregateError")}}, расширяющий {{JSxRef("Error")}}, который содержит указатель на массив(Array) исключений.</li> </ul> diff --git a/files/ru/web/javascript/reference/global_objects/promise/catch/index.html b/files/ru/web/javascript/reference/global_objects/promise/catch/index.html index 5a2ed19b38..e3250af6e5 100644 --- a/files/ru/web/javascript/reference/global_objects/promise/catch/index.html +++ b/files/ru/web/javascript/reference/global_objects/promise/catch/index.html @@ -5,13 +5,13 @@ tags: - ECMAScript6 - JavaScript - Prototype - - Обещание + - Промис - метод translation_of: Web/JavaScript/Reference/Global_Objects/Promise/catch --- <div>{{JSRef}}</div> -<p>Метод <strong>catch()</strong> возвращает <code>Promise(</code>обещание) и работает только в случае отклонения обещания. Ведёт себя аналогично вызову {{jsxref("Promise.then", "Promise.prototype.then(undefined, onRejected)")}}.</p> +<p>Метод <strong>catch()</strong> возвращает промис (<code>Promise(</code>) и работает только в случае отклонения промиса. Ведёт себя аналогично вызову {{jsxref("Promise.then", "Promise.prototype.then(undefined, onRejected)")}}.</p> <h2 id="Syntax">Syntax</h2> @@ -26,12 +26,12 @@ p.catch(function(reason) { <dl> <dt>onRejected</dt> - <dd>{{jsxref("Function")}} вызывается когда обещание отклонено. У этой функции один аргумент: + <dd>{{jsxref("Function")}} вызывается когда промис отклонен. У этой функции один аргумент: <dl> <dt><code>reason</code></dt> <dd>Причина отказа.</dd> <dt> - <p>Promise( Обещание ), возвращённое catch (), отклоняется, если onRejected выдаёт ошибку(throw) или возвращает Promise, который был отклонён; В противном случае Promise, возвращаемый catch () имеет статус выполнено (fulfilled)</p> + <p>Промис, возвращённый catch (), отклоняется, если onRejected выдаёт ошибку(throw) или возвращает Promise, который был отклонён; В противном случае Promise, возвращаемый catch () имеет статус выполнено (fulfilled)</p> </dt> </dl> </dd> @@ -44,7 +44,7 @@ p.catch(function(reason) { <h2 id="Описание">Описание</h2> <dl> - <dd>Метод <code>catch может быть полезен для обработки ошибок</code> в вашей структуре обещаний.</dd> + <dd>Метод <code>catch может быть полезен для обработки ошибок</code> в вашей структуре промисов.</dd> </dl> <h2 id="Примеры">Примеры</h2> @@ -113,7 +113,7 @@ p2.catch(function(e) { console.log(e); // Никогда не вызовется }); -// Ошибки выброшенные после выполнения обещания будут проигнорированны +// Ошибки выброшенные после выполнения промиса будут проигнорированны var p3 = new Promise(function(resolve, reject) { resolve(); throw 'Silenced Exception!'; diff --git a/files/ru/web/javascript/reference/global_objects/promise/finally/index.html b/files/ru/web/javascript/reference/global_objects/promise/finally/index.html index c12f7625a0..3814eb58aa 100644 --- a/files/ru/web/javascript/reference/global_objects/promise/finally/index.html +++ b/files/ru/web/javascript/reference/global_objects/promise/finally/index.html @@ -5,7 +5,7 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise/finally --- <div>{{JSRef}}</div> -<p>Метод <code><strong>finally()</strong></code> возвращает {{jsxref("Promise")}}. Когда <code>Promise</code> (обещание) был выполнен, в не зависимости успешно или с ошибкой, указанная функция будет выполнена. Это даёт возможность запустить один раз определённый участок кода, который должен выполниться вне зависимости от того, с каким результатом выполнился <code>Promise</code>.</p> +<p>Метод <code><strong>finally()</strong></code> возвращает {{jsxref("Promise")}}. Когда промис был выполнен, вне зависимости успешно или с ошибкой, указанная функция будет выполнена. Это даёт возможность запустить один раз определённый участок кода, который должен выполниться вне зависимости от того, с каким результатом выполнился <code>Promise</code>.</p> <p>Это позволяет вам избавиться от дубликации кода в обработчиках {{jsxref("Promise.then", "then()")}} и {{jsxref("Promise.catch", "catch()")}}.</p> @@ -25,7 +25,7 @@ p.finally(() => { <dl> <dt><code>onFinally</code></dt> - <dd>Функция {{jsxref("Function")}} вызываемая когда <code>Promise</code> (обещание) завершено.</dd> + <dd>Функция {{jsxref("Function")}} вызываемая когда промис завершен.</dd> </dl> <h3 id="Возвращаемое_значение">Возвращаемое значение</h3> @@ -34,13 +34,13 @@ p.finally(() => { <h2 id="Описание">Описание</h2> -<p><code>finally()</code> может быть полезен, если необходимо произвести какие-либо вычисления или очистку, как только <code>Promise</code> (обещание) завершено, вне зависимости от результата.</p> +<p><code>finally()</code> может быть полезен, если необходимо произвести какие-либо вычисления или очистку, как только <code>Promise</code> (промис) завершено, вне зависимости от результата.</p> <p><code>finally()</code> очень схож с вызовом <code>.then(onFinally, onFinally)</code>, однако существует несколько различий:</p> <ul> <li>Использование <code>finally()</code> позволяет избежать двойного объявления одной и той же функции или создания переменной. </li> - <li><code>finally</code> не получает аргументов, так как не существует способа определить, будет ли обещание выполнено успешно или с ошибкой. Данный метод необходимо использовать, если не важна причина ошибки или результат успешного выполнения и, следовательно, нет необходимости её/его передавать.</li> + <li><code>finally</code> не получает аргументов, так как не существует способа определить, будет ли промис выполнен успешно или с ошибкой. Данный метод необходимо использовать, если не важна причина ошибки или результат успешного выполнения и, следовательно, нет необходимости её/его передавать.</li> <li>В отличие от <code>Promise.resolve(2).then(() => {}, () => {})</code> (результатом которого будет resolved-промис, со значением <code>undefined</code>), результатом <code>Promise.resolve(2).finally(() => {})</code> будет resolved-промис со значением <code>2</code>.</li> <li>Аналогично, в отличии от <code>Promise.reject(3).then(() => {}, () => {})</code> (результатом которого будет resolved-промис, со значением <code>undefined</code>), результатом <code>Promise.reject(3).finally(() => {})</code> будет rejected-промис со значением <code>3</code>.</li> </ul> diff --git a/files/ru/web/javascript/reference/global_objects/promise/index.html b/files/ru/web/javascript/reference/global_objects/promise/index.html index f942b4fda7..b4075019a6 100644 --- a/files/ru/web/javascript/reference/global_objects/promise/index.html +++ b/files/ru/web/javascript/reference/global_objects/promise/index.html @@ -5,14 +5,14 @@ tags: - ECMAScript6 - JavaScript - Promise - - Обещания + - Промисы translation_of: Web/JavaScript/Reference/Global_Objects/Promise --- <div>{{JSRef}}</div> <h2 id="Сводка">Сводка</h2> -<p>Объект <strong><code>Promise</code></strong> (промис) используется для отложенных и асинхронных вычислений.</p> +<p>Объект <strong><code>Promise</code></strong> используется для отложенных и асинхронных вычислений.</p> <p>{{EmbedInteractiveExample("pages/js/promise-constructor.html")}}</p> @@ -35,7 +35,7 @@ new Promise(function(resolve, reject) { ... });</pre> <h2 id="Описание">Описание</h2> -<p>Интерфейс <code><strong>Promise</strong></code> (промис) представляет собой обёртку для значения, неизвестного на момент создания промиса. Он позволяет обрабатывать результаты асинхронных операций так, как если бы они были синхронными: вместо конечного результата асинхронного метода возвращается <em>обещание </em>(промис)<em> </em>получить результат в некоторый момент в будущем.</p> +<p>Интерфейс <code><strong>Promise</strong></code> (промис) представляет собой обёртку для значения, неизвестного на момент создания промиса. Он позволяет обрабатывать результаты асинхронных операций так, как если бы они были синхронными: вместо конечного результата асинхронного метода возвращается своего рода <em>обещание</em> (дословный перевод слова "промис") получить результат в некоторый момент в будущем.</p> <p><code>Promise</code> может находиться в трёх состояниях:</p> @@ -115,7 +115,7 @@ new Promise(function(resolve, reject) { ... });</pre> // reject("failure reason"); // неудача });</pre> -<p>Чтобы снабдить функцию функциональностью обещаний, нужно просто вернуть в ней объект <code>Promise</code>:</p> +<p>Чтобы снабдить функцию функциональностью промисов, нужно просто вернуть в ней объект <code>Promise</code>:</p> <pre class="brush: js">function myAsyncFunction(url) { return new Promise((resolve, reject) => { @@ -159,7 +159,7 @@ myFirstPromise.then((successMessage) => { <div id="log"></div></pre> </div> -<p>Данный небольшой пример показывает механизм работы с <code>Promise</code>. Метод <code>testPromise()</code> вызывается при каждом нажатии на {{HTMLElement("button")}}. При этом создаётся промис, которое успешно выполняется при помощи <code>window.setTimeout</code>, со значением <code>'result'</code> в случайном интервале от 1 до 3-х секунд.</p> +<p>Данный небольшой пример показывает механизм работы с <code>Promise</code>. Метод <code>testPromise()</code> вызывается при каждом нажатии на {{HTMLElement("button")}}. При этом создаётся промис, который успешно выполняется при помощи <code>window.setTimeout</code>, со значением <code>'result'</code> в случайном интервале от 1 до 3-х секунд.</p> <p>исполнение промиса протоколируется при помощи продолжения <code>p1.then</code>. Это показывает как синхронная часть метода отвязана от асинхронного завершения промиса.</p> @@ -183,22 +183,22 @@ function testPromise() { // Это всего лишь пример асинхронности window.setTimeout( function() { - // Обещание исполнено! + // Промис исполнен! resolve(thisPromiseCount) }, Math.random() * 2000 + 1000); }); - // Указываем, что сделать с исполненным промисм + // Указываем, что сделать с исполненным промисом p1.then( // Записываем в протокол function(val) { log.insertAdjacentHTML('beforeend', val + - ') Обещание исполнено (асинхронный код завершён) + ') Промис исполнен (асинхронный код завершён) '); }); log.insertAdjacentHTML('beforeend', thisPromiseCount + - ') Обещание создано (синхронный код завершён) + ') Промис создан (синхронный код завершён) '); } </pre> diff --git a/files/ru/web/javascript/reference/global_objects/promise/race/index.html b/files/ru/web/javascript/reference/global_objects/promise/race/index.html index fbce7aeb3c..c77e1fdc1c 100644 --- a/files/ru/web/javascript/reference/global_objects/promise/race/index.html +++ b/files/ru/web/javascript/reference/global_objects/promise/race/index.html @@ -4,13 +4,13 @@ slug: Web/JavaScript/Reference/Global_Objects/Promise/race tags: - ECMAScript6 - Promise - - Обещание + - Промис - метод translation_of: Web/JavaScript/Reference/Global_Objects/Promise/race --- <div>{{JSRef}}</div> -<p>Метод<strong> Promise.race(iterable)</strong> возвращает выполненное или отклонённое обещание, в зависимости от того, с каким результатом завершится первое из переданных обещаний, со значением или причиной отклонения этого обещания.</p> +<p>Метод<strong> Promise.race(iterable)</strong> возвращает выполненный или отклонённый промис, в зависимости от того, с каким результатом завершится первый из переданных промисов, со значением или причиной отклонения этого промиса.</p> <p>{{EmbedInteractiveExample("pages/js/promise-race.html")}}</p> @@ -27,11 +27,11 @@ translation_of: Web/JavaScript/Reference/Global_Objects/Promise/race <h3 id="Возвращаемое_значение">Возвращаемое значение</h3> -<p>Выполненный или отклонённый {{jsxref("Promise")}} в зависимости от результата первого завершённого из переданных в итерируемом объекте обещаний.</p> +<p>Выполненный или отклонённый {{jsxref("Promise")}} в зависимости от результата первого завершённого из переданных в итерируемом объекте промисов.</p> <h2 id="Описание">Описание</h2> -<p>Метод <code>race</code> возвращает <code>Обещание </code>(<code>Promise</code>) с результатом, первого завершённого из переданных обещаний. Т.е. возвратит resolve или reject, в зависимости от того, что случится первым.</p> +<p>Метод <code>race</code> возвращает <code>Promise</code> с результатом, первого завершённого из переданных промисов. Т.е. возвратит resolve или reject, в зависимости от того, что случится первым.</p> <h2 id="Примеры">Примеры</h2> diff --git a/files/ru/web/javascript/reference/global_objects/promise/resolve/index.html b/files/ru/web/javascript/reference/global_objects/promise/resolve/index.html index 1587d254ac..9c10bef5ee 100644 --- a/files/ru/web/javascript/reference/global_objects/promise/resolve/index.html +++ b/files/ru/web/javascript/reference/global_objects/promise/resolve/index.html @@ -4,13 +4,13 @@ slug: Web/JavaScript/Reference/Global_Objects/Promise/resolve tags: - ECMAScript6 - JavaScript - - Обещание + - Промис - метод translation_of: Web/JavaScript/Reference/Global_Objects/Promise/resolve --- <div>{{JSRef}}</div> -<p>Метод <code><strong>Promise.resolve(value)</strong></code> возвращает {{jsxref("Promise")}} выполненный с переданным значением. Если переданное значение является thenable - объект (т.е. имеет метод {{jsxref("Promise.then", "\"then\" method")}}), возвращаемое обещание будет следовать thenable - объекту, принимая своё состояние; в ином случае возвращаемое обещание будет выполнено с переданным значением.</p> +<p>Метод <code><strong>Promise.resolve(value)</strong></code> возвращает {{jsxref("Promise")}} выполненный с переданным значением. Если переданное значение является thenable - объект (т.е. имеет метод {{jsxref("Promise.then", "\"then\" method")}}), возвращаемый промис будет следовать thenable - объекту, принимая своё состояние; в ином случае возвращаемый промис будет выполнен с переданным значением.</p> <h2 id="Синтаксис">Синтаксис</h2> @@ -23,7 +23,7 @@ Promise.resolve(thenable); <dl> <dt>value</dt> - <dd>Значение с которым будет выполнено обещание. Может также быть обещанием или объект подобный обещанию (thenable - объект имеющий метод then).</dd> + <dd>Значение с которым будет выполнен промис. Может также быть промисом или объект подобный промису (thenable - объект имеющий метод then).</dd> </dl> <h3 id="Возвращаемое_значение">Возвращаемое значение</h3> @@ -32,7 +32,7 @@ Promise.resolve(thenable); <h2 id="Описание">Описание</h2> -<p><code>Метод Promise.resolve</code> возвращает выполненное обещание (<code>Promise</code>).</p> +<p><code>Метод Promise.resolve</code> возвращает выполненное промис (<code>Promise</code>).</p> <h2 id="Примеры">Примеры</h2> @@ -53,7 +53,7 @@ p.then(function(v) { }); </pre> -<h3 id="Выполнение_с_другим_обещанием_Promise">Выполнение с другим обещанием ( <code>Promise</code>)</h3> +<h3 id="Выполнение_с_другим_промисом_Promise">Выполнение с другим промисом ( <code>Promise</code>)</h3> <pre class="brush: js">var original = Promise.resolve(true); var cast = Promise.resolve(original); diff --git a/files/ru/web/javascript/reference/global_objects/promise/then/index.html b/files/ru/web/javascript/reference/global_objects/promise/then/index.html index 0a347a9778..5bdc241aa9 100644 --- a/files/ru/web/javascript/reference/global_objects/promise/then/index.html +++ b/files/ru/web/javascript/reference/global_objects/promise/then/index.html @@ -58,7 +58,7 @@ p1.then(function(value) { <h3 id="Соединение">Соединение</h3> -<p>Так как метод <code>then</code> возвращает <code>Promise</code> (обещание), вы можете объединить несколько вызовов <code>then</code> в цепочку. Значения возвращаемые из onFulfilled или onRejected колбэков будут автоматически обёрнуты в обещание.</p> +<p>Так как метод <code>then</code> возвращает промис (<code>Promise</code>), вы можете объединить несколько вызовов <code>then</code> в цепочку. Значения возвращаемые из колбэков onFulfilled или onRejected будут автоматически обёрнуты в промис.</p> <pre class="brush: js notranslate">var p2 = new Promise(function(resolve, reject) { resolve(1); @@ -76,10 +76,10 @@ p2.then(function(value) { }); </pre> -<p>Вы также можете соединить одну функцию, имеющую подобную с обещаниями API, с другой функцией.</p> +<p>Вы также можете соединить одну функцию, имеющую подобный с промисами API, с другой функцией.</p> <pre class="brush: js notranslate">function fetch_current_data() { - // API функции fetch() возвращает обещание. Эта функция + // API функции fetch() возвращает промис. Эта функция // имеет аналогичный API, за исключением значения в случае выполнения return fetch("current-data.json").then((response) => { if (response.headers.get("content-type") != "application/json") { @@ -87,13 +87,13 @@ p2.then(function(value) { } var j = response.json(); // можем что-нибудь делать с j - return j; // в случае выполнения обещания, значение + return j; // в случае выполнения промиса, значение // передаётся в fetch_current_data().then() }); } </pre> -<p>Если onFulfilled возвращает обещание, возвращаемое значение может быть выполнено (resolved) / отклонено (rejected) обещанием.</p> +<p>Если onFulfilled возвращает промис, возвращаемое значение может быть выполнено (resolved) / отклонено (rejected) промисом.</p> <pre class="brush: js notranslate">function resolveLater(resolve, reject) { setTimeout(function () { @@ -108,7 +108,7 @@ function rejectLater(resolve, reject) { var p1 = Promise.resolve("foo"); var p2 = p1.then(function() { - // Возвращает обещание, которое будет разрешено значением 10 через 1 секунду + // Возвращает промис, который будет разрешен значением 10 через 1 секунду return new Promise(resolveLater); }); p2.then(function(v) { @@ -119,7 +119,7 @@ p2.then(function(v) { }); var p3 = p1.then(function() { -// Возвращает обещание, которое будет отброшено значением 20 через 1 секунду +// Возвращает промис, который будет отброшен значением 20 через 1 секунду return new Promise(rejectLater); }); p3.then(function(v) { diff --git a/files/ru/web/javascript/reference/global_objects/webassembly/compile/index.html b/files/ru/web/javascript/reference/global_objects/webassembly/compile/index.html index a3c8f5e34f..8cbcd47e36 100644 --- a/files/ru/web/javascript/reference/global_objects/webassembly/compile/index.html +++ b/files/ru/web/javascript/reference/global_objects/webassembly/compile/index.html @@ -20,13 +20,13 @@ translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/compile <h3 id="Возвращаемое_значение">Возвращаемое значение</h3> -<p>Обещание, (<code>Promise</code>), которое разрешает объект {{jsxref("WebAssembly.Module")}}, представляющий скомпилированный модуль.</p> +<p>Промис (<code>Promise</code>), который разрешает объект {{jsxref("WebAssembly.Module")}}, представляющий скомпилированный модуль.</p> <h3 id="Исключения">Исключения</h3> <ul> <li>Если <code>bufferSource</code> не является <a href="/en-US/docs/Web/JavaScript/Typed_arrays">typed array</a>, генерируется {{jsxref("TypeError")}}.</li> - <li>Если компиляция не удалась, обещание отклоняется с помощью {{jsxref("WebAssembly.CompileError")}}.</li> + <li>Если компиляция не удалась, промис отклоняется с помощью {{jsxref("WebAssembly.CompileError")}}.</li> </ul> <h2 id="Примеры">Примеры</h2> diff --git a/files/ru/web/javascript/reference/global_objects/webassembly/compilestreaming/index.html b/files/ru/web/javascript/reference/global_objects/webassembly/compilestreaming/index.html index 79b702b091..fd49c70591 100644 --- a/files/ru/web/javascript/reference/global_objects/webassembly/compilestreaming/index.html +++ b/files/ru/web/javascript/reference/global_objects/webassembly/compilestreaming/index.html @@ -15,24 +15,24 @@ translation_of: Web/JavaScript/Reference/Global_Objects/WebAssembly/compileStrea <dl> <dt><em>source</em></dt> - <dd>Обещание, или {{domxref("Response")}}, которое будет выполнено с одним, представляющим основной источник модулем <code>.wasm</code>, который вы хотите передать и скомпилировать.</dd> + <dd>Промис, или {{domxref("Response")}}, который будет выполнен с одним, представляющим основной источник модулем <code>.wasm</code>, который вы хотите передать и скомпилировать.</dd> </dl> <h3 id="Возвращаемое_значение">Возвращаемое значение</h3> -<p>Обещание, ( <code>Promise</code>), которое разрешает объект {{jsxref("WebAssembly.Module")}}, представляющий скомпилированный модуль.</p> +<p>Промис (<code>Promise</code>), который разрешает объект {{jsxref("WebAssembly.Module")}}, представляющий скомпилированный модуль.</p> <h3 id="Исключения">Исключения</h3> <ul> <li>Если <code>bufferSource</code> не является <a href="/en-US/docs/Web/JavaScript/Typed_arrays">typed array</a>, генерируется {{jsxref("TypeError")}}.</li> - <li>Если компиляция не удалась, обещание отклоняется с помощью {{jsxref("WebAssembly.CompileError")}}.</li> + <li>Если компиляция не удалась, промис отклоняется с помощью {{jsxref("WebAssembly.CompileError")}}.</li> </ul> <h2 id="Примеры">Примеры</h2> <p>Следующий пример (см. Нашу демонстрацию <a href="https://github.com/mdn/webassembly-examples/blob/master/js-api-examples/compile-streaming.html">compile-streaming.html</a> на GitHub и <a href="https://mdn.github.io/webassembly-examples/js-api-examples/compile-streaming.html">view it live</a>) напрямую передаёт модуль .wasm из исходника, затем компилирует его в объект {{jsxref("WebAssembly.Module")}}.<br> - Поскольку функция <code>compileStreaming()</code> принимает обещание для объекта {{domxref("Response")}}, вы можете напрямую передать ему вызов {{domxref("WindowOrWorkerGlobalScope.fetch()")}}, и он передаст ответ в выполняемую функцию.</p> + Поскольку функция <code>compileStreaming()</code> принимает промис для объекта {{domxref("Response")}}, вы можете напрямую передать ему вызов {{domxref("WindowOrWorkerGlobalScope.fetch()")}}, и он передаст ответ в выполняемую функцию.</p> <pre class="brush: js">var importObject = { imports: { imported_func: arg => console.log(arg) } }; |