Promise.prototype.catch()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Phương thức catch() của các thực thể Promise lên lịch một hàm được gọi khi promise bị từ chối. Nó ngay lập tức trả về một đối tượng Promise khác, cho phép bạn kết nối chuỗi các lời gọi đến các phương thức promise khác. Đây là shortcut cho then(undefined, onRejected).
Try it
const promise = new Promise((resolve, reject) => {
throw new Error("Uh-oh!");
});
promise.catch((error) => {
console.error(error);
});
// Expected output: Error: Uh-oh!
Cú pháp
promiseInstance.catch(onRejected)
Tham số
onRejected-
Một hàm được thực thi bất đồng bộ khi promise này bị từ chối. Giá trị trả về của nó trở thành giá trị fulfillment của promise được trả về bởi
catch(). Hàm được gọi với các đối số sau:reason-
Giá trị mà promise bị từ chối với.
Giá trị trả về
Trả về một Promise mới. Promise mới này luôn đang chờ xử lý khi được trả về, bất kể trạng thái của promise hiện tại. Nếu onRejected được gọi, promise được trả về sẽ resolve dựa trên giá trị trả về của lời gọi này, hoặc bị từ chối với lỗi được ném ra từ lời gọi này. Nếu promise hiện tại được thực hiện, onRejected không được gọi và promise được trả về thực hiện với cùng giá trị.
Mô tả
Phương thức catch được sử dụng để xử lý lỗi trong thành phần promise. Vì nó trả về một Promise, nó có thể được kết nối chuỗi theo cùng cách như phương thức anh em của nó, then().
Nếu một promise bị từ chối, và không có rejection handler nào được gọi (một trình xử lý có thể được đính kèm thông qua bất kỳ then(), catch(), hoặc finally()), thì sự kiện rejection sẽ được hiển thị bởi host. Trong trình duyệt, điều này dẫn đến một sự kiện unhandledrejection. Nếu một trình xử lý được đính kèm vào một promise bị từ chối mà rejection của nó đã gây ra một sự kiện unhandled rejection, thì một sự kiện rejectionhandled khác được kích hoạt.
catch() nội bộ gọi then() trên đối tượng mà nó được gọi, truyền undefined và onRejected làm đối số. Giá trị của lời gọi đó được trả về trực tiếp. Điều này có thể quan sát được nếu bạn bọc các phương thức.
// ghi đè Promise.prototype.then/catch gốc để thêm một số log
((Promise) => {
const originalThen = Promise.prototype.then;
const originalCatch = Promise.prototype.catch;
Promise.prototype.then = function (...args) {
console.log("Called .then on %o with arguments: %o", this, args);
return originalThen.apply(this, args);
};
Promise.prototype.catch = function (...args) {
console.error("Called .catch on %o with arguments: %o", this, args);
return originalCatch.apply(this, args);
};
})(Promise);
// gọi catch trên một promise đã được resolved
Promise.resolve().catch(function XXX() {});
// Logs:
// Called .catch on Promise{} with arguments: Arguments{1} [0: function XXX()]
// Called .then on Promise{} with arguments: Arguments{2} [0: undefined, 1: function XXX()]
Điều này có nghĩa là truyền undefined vẫn khiến promise được trả về bị từ chối, và bạn phải truyền một hàm để ngăn promise cuối cùng bị từ chối.
Vì catch() chỉ gọi then(), nó hỗ trợ phân lớp con.
Ví dụ
Sử dụng và kết nối chuỗi phương thức catch()
const p1 = new Promise((resolve, reject) => {
resolve("Success");
});
p1.then((value) => {
console.log(value); // "Success!"
throw new Error("oh, no!");
})
.catch((e) => {
console.error(e.message); // "oh, no!"
})
.then(
() => console.log("after a catch the chain is restored"), // "after a catch the chain is restored"
() => console.log("Not fired due to the catch"),
);
// Phần sau đây hoạt động giống như trên
p1.then((value) => {
console.log(value); // "Success!"
return Promise.reject(new Error("oh, no!"));
})
.catch((e) => {
console.error(e); // Error: oh, no!
})
.then(
() => console.log("after a catch the chain is restored"), // "after a catch the chain is restored"
() => console.log("Not fired due to the catch"),
);
Những điều cần lưu ý khi ném lỗi
Ném lỗi sẽ gọi phương thức catch() trong hầu hết các trường hợp:
const p1 = new Promise((resolve, reject) => {
throw new Error("Uh-oh!");
});
p1.catch((e) => {
console.error(e); // "Uh-oh!"
});
Các lỗi được ném bên trong các hàm bất đồng bộ sẽ hoạt động như các lỗi không được bắt:
const p2 = new Promise((resolve, reject) => {
setTimeout(() => {
throw new Error("Uncaught Exception!");
}, 1000);
});
p2.catch((e) => {
console.error(e); // Điều này không bao giờ được gọi
});
Các lỗi được ném sau khi resolve được gọi sẽ bị im lặng:
const p3 = new Promise((resolve, reject) => {
resolve();
throw new Error("Silenced Exception!");
});
p3.catch((e) => {
console.error(e); // Điều này không bao giờ được gọi
});
catch() không được gọi nếu promise được thực hiện
// Tạo một promise sẽ không gọi onReject
const p1 = Promise.resolve("calling next");
const p2 = p1.catch((reason) => {
// Điều này không bao giờ được gọi
console.error("catch p1!");
console.error(reason);
});
p2.then(
(value) => {
console.log("next promise's onFulfilled");
console.log(value); // calling next
},
(reason) => {
console.log("next promise's onRejected");
console.log(reason);
},
);
Thông số kỹ thuật
| Specification |
|---|
| ECMAScript® 2027 Language Specification # sec-promise.prototype.catch |