关于 JavaScript 错误处理的最完整指南(下半部)
使用 Promise 处理错误
为了演示 Promise 处理方式，我们先回到一开始的那个事例：
function toUppercase(string) {
if (typeof string !== "string") {
throw TypeError("Wrong type given, expected a string");
}
return string.toUpperCase();
}
toUppercase(4); 相对简单抛出异常，我们可以使用 Promise.reject 和Promise.resolve:
function toUppercase(string) {
if (typeof string !== "string") {
return Promise.reject(TypeError("Wrong type given, expected a string"));
}
const result = string.toUpperCase();
return Promise.resolve(result);
} 因为使用了 Promise ，所以可以使用 then 来接收返回的内容，或者用 catch 来捕获出现的错误。
toUppercase(99) .then(result => result) .catch(error => console.error(error.message));
上面的执行结果：
Wrong type given, expected a string
除了 then 和 catch , Promise 中还有 finally 方法，这类似于try/catch 中的 finally。
toUppercase(99)
.then(result => result)
.catch(error => console.error(error.message))
.finally(() => console.log("Run baby, run")); Promise, error, 和 throw
使用 Promise.reject 可以很方便的抛出错误：
Promise.reject(TypeError("Wrong type given, expected a string")); 除了Promise.reject，我们也可以通过抛出异常来退出 Promise。
考虑以下示例：
Promise.resolve("A string").then(value => {
if (typeof value === "string") {
throw TypeError("Expected a number!");
}
}); 要停止异常传播，我们照常使用catch：
Promise.resolve("A string")
.then(value => {
if (typeof value === "string") {
throw TypeError("Expected a number!");
}
})
.catch(reason => console.log(reason.message)); 这种模式在fetch中很常见:
fetch("https://example-dev/api/")
.then(response => {
if (!response.ok) {
throw Error(response.statusText);
}
return response.json();
})
.then(json => console.log(json)); 这里可以使用catch拦截异常。如果我们失败了，或者决定不捕获它，异常可以在堆栈中自由冒泡。
使用 Promise 来处理定时器中的异常
使用定时器或事件无法捕获从回调引发的异常。
function failAfterOneSecond() {
setTimeout(() => {
throw Error("Something went wrong!");
}, 1000);
}
// DOES NOT WORK
try {
failAfterOneSecond();
} catch (error) {
console.error(error.message);
} 解决方案就是使用 Promise:
function failAfterOneSecond() {
return new Promise((_, reject) => {
setTimeout(() => {
reject(Error("Something went wrong!"));
}, 1000);
});
} 使用reject，我们启动了一个 Promise 拒绝，它携带一个错误对象。
此时，我们可以使用catch处理异常:
failAfterOneSecond().catch(reason => console.error(reason.message));
使用 Promise.all 来处理错误
Promise.all(iterable) 方法返回一个 Promise 实例，此实例在 iterable 参数内所有的 promise 都“完成(resolved)”或参数中不包含 promise 时回调完成(resolve);
const promise1 = Promise.resolve("All good!");
const promise2 = Promise.resolve("All good here too!");
Promise.all([promise1, promise2]).then((results) => console.log(results));
// [ 'All good!', 'All good here too!' ] 如果参数中 promise 有一个失败(rejected)，此实例回调失败(reject)，失败的原因是第一个失败 promise 的结果。
const promise1 = Promise.resolve("All good!");
const promise2 = Promise.reject(Error("No good, sorry!"));
const promise3 = Promise.reject(Error("Bad day ..."));
Promise.all([promise1, promise2, promise3])
.then(results => console.log(results))
.catch(error => console.error(error.message));
// No good, sorry! 同样，无论Promise.all的结果如何运行函数，finally 都会被执行：
Promise.all([promise1, promise2, promise3])
.then(results => console.log(results))
.catch(error => console.error(error.message))
.finally(() => console.log("Always runs!")); 使用 Promise.any 来处理错误
Promise.any() (Firefox > 79, Chrome > 85) 接收一个 Promise 可迭代对象，只要其中的一个 promise 成功，就返回那个已经成功的 promise 。如果可迭代对象中没有一个 promise 成功(即所有的 promises 都失败/拒绝)，就返回一个失败的 promise 和AggregateError类型的实例，它是 Error 的一个子类，用于把单一的错误集合在一起。本质上，这个方法和Promise.all()是相反的。
const promise1 = Promise.reject(Error("No good, sorry!"));
const promise2 = Promise.reject(Error("Bad day ..."));
Promise.any([promise1, promise2])
.then(result => console.log(result))
.catch(error => console.error(error))
.finally(() => console.log("Always runs!")); 在这里，我们使用catch处理错误，输出如下：
AggregateError: No Promise in Promise.any was resolved Always runs!
AggregateError对象具有与基本Error相同的属性，外加errors属性：
// .catch(error => console.error(error.errors)) //
此属性是由reject产生的每个单独错误的数组
[Error: "No good, sorry!, Error: "Bad day ..."]
使用 Promise.race 来处理错误
Promise.race(iterable) 方法返回一个 promise，一旦迭代器中的某个promise解决或拒绝，返回的 promise就会解决或拒绝。
const promise1 = Promise.resolve("The first!");
const promise2 = Promise.resolve("The second!");
Promise.race([promise1, promise2]).then(result => console.log(result));
// The first! 这里说明，第一个 Promise 比第二个行执行完。那包含拒绝的情况又是怎么样的?
const promise1 = Promise.resolve("The first!");
const rejection = Promise.reject(Error("Ouch!"));
const promise2 = Promise.resolve("The second!");
Promise.race([promise1, rejection, promise2]).then(result =>
console.log(result)
);
// The first! 如果把reject放在第一个又会怎么样?
const promise1 = Promise.resolve("The first!");
const rejection = Promise.reject(Error("Ouch!"));
const promise2 = Promise.resolve("The second!");
Promise.race([rejection, promise1, promise2])
.then(result => console.log(result))
.catch(error => console.error(error.message));
// Ouch! 使用 Promise.allSettled 来处理错误
Promise.allSettled()方法返回一个在所有给定的promise都已经fulfilled或rejected后的promise，并带有一个对象数组，每个对象表示对应的promise结果。
考虑下面示例：
const promise1 = Promise.resolve("Good!");
const promise2 = Promise.reject(Error("No good, sorry!"));
Promise.allSettled([promise1, promise2])
.then(results => console.log(results))
.catch(error => console.error(error))
.finally(() => console.log("Always runs!")); 我们传递给Promise.allSettled一个由两个Promise组成的数组：一个已解决，另一个被拒绝。
这种情况 catch 不会被执行， finally 永远会执行。
[
{ status: 'fulfilled', value: 'Good!' },
{
status: 'rejected',
reason: Error: No good, sorry!
}
] 使用 async/await 来处理错误
为了简单起见，我们使用前面的同步函数toUppercase，并通过在function关键字前放置async来将其转换为异步函数
async function toUppercase(string) {
if (typeof string !== "string") {
throw TypeError("Wrong type given, expected a string");
}
return string.toUpperCase();
} 只要在函数前面加上async，该函数就会返回一个Promise。这意味着我们可以在函数调用之后进行then、catch和finally 操作
async function toUppercase(string) {
if (typeof string !== "string") {
throw TypeError("Wrong type given, expected a string");
}
return string.toUpperCase();
}
toUppercase("abc")
.then(result => console.log(result))
.catch(error => console.error(error.message))
.finally(() => console.log("Always runs!")); 当从 async 函数抛出异常时，我们就可以使用 catch 来捕获。
最重要的是，除了这种方式外，我们可以还使用try/catch/finally，就像我们使用同步函数所做的一样。
async function toUppercase(string) {
if (typeof string !== "string") {
throw TypeError("Wrong type given, expected a string");
}
return string.toUpperCase();
}
async function consumer() {
try {
await toUppercase(98);
} catch (error) {
console.error(error.message);
} finally {
console.log("Always runs!");
}
}
consumer(); 输出：
Wrong type given, expected a string Always runs!
使用 async generators 来处理错误
JavaScript中的async generators是能够生成 Promises 而不是简单值的生成器函数。
async function* asyncGenerator() {
yield 33;
yield 99;
throw Error("Something went wrong!"); // Promise.reject
} 基于 Promise，此处适用于错误处理的相同规则。在异步生成器中 throw 将会触发 Promise 的reject，我们可以使用catch对其进行拦截。
为了使用异步生成器的 Promise，我们可以这样做：
- then 方法
- 异步遍历
从上面我们知道，在两次调用 yield之后，下一次会抛出一个异常：
const go = asyncGenerator(); go.next().then(value => console.log(value)); go.next().then(value => console.log(value)); go.next().catch(reason => console.error(reason.message));
输出结果：
{ value: 33, done: false }
{ value: 99, done: false }
Something went wrong! 别一种是使用 异步遍历与for await...of:
async function* asyncGenerator() {
yield 33;
yield 99;
throw Error("Something went wrong!"); // Promise.reject
}
async function consumer() {
for await (const value of asyncGenerator()) {
console.log(value);
}
}
consumer(); 有了 async/await 我们可以使用 try/catch 来捕获异常：
async function* asyncGenerator() {
yield 33;
yield 99;
throw Error("Something went wrong!"); // Promise.reject
}
async function consumer() {
try {
for await (const value of asyncGenerator()) {
console.log(value);
}
} catch (error) {
console.error(error.message);
}
}
consumer(); 输出结果：
33 99 Something went wrong!
从异步生成器函数返回的迭代器对象也具有throw()方法，非常类似于其同步副本。在此处的迭代器对象上调用throw()不会引发异常，但是会被Promise拒绝
async function* asyncGenerator() {
yield 33;
yield 99;
yield 11;
}
const go = asyncGenerator();
go.next().then(value => console.log(value));
go.next().then(value => console.log(value));
go.throw(Error("Let's reject!"));
go.next().then(value => console.log(value)); // value is undefined 要从外部处理这种情况，我们可以做：
go.throw(Error("Let's reject!")).catch(reason => console.error(reason.message)); Node 中的错误处理
Node 中的同步错误处理
Node.js 中的同步错误处理与到目前为止所看到的并没有太大差异。对于同步，使用 try/catch/finally 就可以很好的工作了。
Node.js 中的异步错误处理：回调模式
对于异步代码，Node.js 主要使用这两种方式：
- 回调模式
- event emitters
在回调模式中，异步 Node.js API 接受一个函数，该函数通过事件循环处理，并在调用堆栈为空时立即执行。
考虑以下代码:
const { readFile } = require("fs");
function readDataset(path) {
readFile(path, { encoding: "utf8" }, function(error, data) {
if (error) console.error(error);
// do stuff with the data
});
} 我们可以看到，这里处理错误的方式是使用了回调：
//
function(error, data) {
if (error) console.error(error);
// do stuff with the data
}
// 如果使用fs.readFile读取给定路径而引起任何错误，我们将获得一个错误对象。
在这一点上，我们可以：
- 简单的把对象错误打出来
- 抛出错误
- 把错误传到另一个回调
我们可以抛出一个异常
const { readFile } = require("fs");
function readDataset(path) {
readFile(path, { encoding: "utf8" }, function(error, data) {
if (error) throw Error(error.message);
// do stuff with the data
});
} 但是，与 DOM 中的事件和定时器一样，此异常将使程序崩溃。通过try/catch捕获它是不起作用的：
const { readFile } = require("fs");
function readDataset(path) {
readFile(path, { encoding: "utf8" }, function(error, data) {
if (error) throw Error(error.message);
// do stuff with the data
});
}
try {
readDataset("not-here.txt");
} catch (error) {
console.error(error.message);
} 如果我们不想使程序崩溃，则将错误传递给另一个回调是首选方法：
const { readFile } = require("fs");
function readDataset(path) {
readFile(path, { encoding: "utf8" }, function(error, data) {
if (error) return errorHandler(error);
// do stuff with the data
});
} 这里的errorHandler顾名思义，是一个用于错误处理的简单函数:
function errorHandler(error) {
console.error(error.message);
// do something with the error:
// - write to a log.
// - send to an external logger.
} Node.js 中的异步错误处理：event emitters
在 Node.js 中所做的大部分工作都是基于事件的。大多数情况下，emitter object 和一些观察者进行交互以侦听消息。
Node.js中的任何事件驱动模块(例如net)都扩展了一个名为EventEmitter的根类。
Node.js中的EventEmitter有两种基本方法：on和emit。
考虑以下简单的 HTTP 服务器：
const net = require("net");
const server = net.createServer().listen(8081, "127.0.0.1");
server.on("listening", function () {
console.log("Server listening!");
});
server.on("connection", function (socket) {
console.log("Client connected!");
socket.end("Hello client!");
}); 这里我们来听两个事件:listening 和connection。除了这些事件之外，event emitters 还公开一个 error 事件，以防发生错误。
如果在端口80上运行这段代码，而不是在前面的示例上侦听，将会得到一个异常：
const net = require("net");
const server = net.createServer().listen(80, "127.0.0.1");
server.on("listening", function () {
console.log("Server listening!");
});
server.on("connection", function (socket) {
console.log("Client connected!");
socket.end("Hello client!");
}); 输出：
events.js:291 throw er; // Unhandled 'error' event ^ Error: listen EACCES: permission denied 127.0.0.1:80 Emitted 'error' event on Server instance at: ...
要捕获它，我们可以注册一个error事件处理程序：
server.on("error", function(error) {
console.error(error.message);
}); 输出结果：
listen EACCES: permission denied 127.0.0.1:80
总结
在这个指南中，我们介绍了JavaScript的各种错误处理，从简单的同步代码到高级的异步。在JavaScript程序中，可以通过多种方式来捕获异常。
同步代码中的异常是最容易捕获的。相反，异步中的异常需要一些技巧来处理。
浏览器中的新JavaScript API几乎都偏向 Promise。then/catch/finally或try/catch的模式对于async/await的异常处理变得更加容易。
作者：Valentino Gagliardi 译者：前端小智 来源：valentinog
原文：https://www.valentinog.com/blog/error/