From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../global_objects/promise/catch/index.html | 157 +++++++++++++++++++++ 1 file changed, 157 insertions(+) create mode 100644 files/ru/web/javascript/reference/global_objects/promise/catch/index.html (limited to 'files/ru/web/javascript/reference/global_objects/promise/catch') 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 new file mode 100644 index 0000000000..dee70fbc24 --- /dev/null +++ b/files/ru/web/javascript/reference/global_objects/promise/catch/index.html @@ -0,0 +1,157 @@ +--- +title: Promise.prototype.catch() +slug: Web/JavaScript/Reference/Global_Objects/Promise/catch +tags: + - ECMAScript6 + - JavaScript + - Prototype + - Обещание + - метод +translation_of: Web/JavaScript/Reference/Global_Objects/Promise/catch +--- +
{{JSRef}}
+ +

Метод catch() возвращает Promise(обещание) и работает только в случае отклонения обещания. Ведет себя аналогично вызову {{jsxref("Promise.then", "Promise.prototype.then(undefined, onRejected)")}}.

+ +

Syntax

+ +
p.catch(onRejected);
+
+p.catch(function(reason) {
+   // отказ
+});
+
+ +

Параметры

+ +
+
onRejected
+
{{jsxref("Function")}} вызывается когда обещание отклонено. У этой функции один аргумент: +
+
reason
+
Причина отказа.
+
+

Promise( Обещание ), возвращенное catch (), отклоняется, если onRejected выдает ошибку(throw) или возвращает Promise, который был отклонен; В противном случае Promise, возвращаемый catch () имеет статус  выполнено  (fulfilled)

+
+
+
+
+ +

Возвращаемое значение

+ +

{{jsxref("Promise")}}.

+ +

Описание

+ +
+
Метод catch может быть полезен для обработки ошибок в вашей структуре обещаний.
+
+ +

Примеры

+ +

Использование метода catch

+ +
var p1 = new Promise(function(resolve, reject) {
+  resolve('Success');
+});
+
+p1.then(function(value) {
+  console.log(value); // "Success!"
+  throw 'oh, no!';
+}).catch(function(e) {
+  // Функция не перевыбросила исключение 'e'
+  // в результате произойдёт resolve(undefined)
+  // для Promise, возвращённого функцией catch
+  console.log(e); // "oh, no!"
+}).then(function(){
+  console.log('after a catch the chain is restored');
+}, function () {
+  // Функция не перевыбросила исключение 'e'
+  // в результате произойдёт resolve(undefined)
+  // для Promise, возвращённого функцией catch
+  console.log('Not fired due to the catch');
+});
+
+// Следующий код ведет себя также, как вышенаписанный
+p1.then(function(value) {
+  console.log(value); // "Success!"
+  return Promise.reject('oh, no!');
+}).catch(function(e) {
+  // Функция не перевыбросила исключение 'e'
+  // в результате произойдёт resolve(undefined)
+  // для Promise, возвращённого функцией catch
+  console.log(e); // "oh, no!"
+}).then(function(){
+  console.log('after a catch the chain is restored');
+}, function () {
+  // Функция не перевыбросила исключение 'e'
+  // в результате произойдёт resolve(undefined)
+  // для Promise, возвращённого функцией catch
+  console.log('Not fired due to the catch');
+});
+
+ +

Ловим выброшеные исключения

+ +
// Выкидываемая ошибка вызовет метод catch
+var p1 = new Promise(function(resolve, reject) {
+  throw 'Uh-oh!';
+});
+
+p1.catch(function(e) {
+  console.log(e); // "Uh-oh!"
+});
+
+// Ошибки выброшеные из асинхронных функций не будут пойманы методом catch
+var p2 = new Promise(function(resolve, reject) {
+  setTimeout(function() {
+    throw 'Uncaught Exception!';
+  }, 1000);
+});
+
+p2.catch(function(e) {
+  console.log(e); // Никогда не вызовется
+});
+
+// Ошибки выброшеные после выполнения обещания будут проигнорированны
+var p3 = new Promise(function(resolve, reject) {
+  resolve();
+  throw 'Silenced Exception!';
+});
+
+p3.catch(function(e) {
+   console.log(e); // Никогда не вызовется
+});
+ +

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

+ + + + + + + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('ES6', '#sec-promise.prototype.catch', 'Promise.prototype.catch')}}{{Spec2('ES6')}}Initial definition in an ECMA standard.
{{SpecName('ESDraft', '#sec-promise.prototype.catch', 'Promise.prototype.catch')}}{{Spec2('ESDraft')}} 
+ +

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

+ +

{{Compat("javascript.builtins.Promise.catch")}}

+ +

Смотри также

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