AsyncGenerator 实例的 throw() 方法的作用就好像一个 throw 语句被插入到生成器主体的当前暂停位置,这会通知生成器错误的情况并允许其处理错误,或者执行清理和自行关闭。
语法
asyncGeneratorInstance.throw(exception)
参数
exception- : 要抛出的异常。使用
Error实例对调试非常有帮助。
- : 要抛出的异常。使用
返回值
如果抛出的错误没有被捕获,它会返回一个以传入的异常拒绝的 Promise。
如果抛出的异常被 try...catch 捕获并且生成器恢复生成更多的值,它将返回一个 Promise,其兑现为带有两个属性的 Object:
done- : 一个布尔值:
- 如果该生成器函数的控制流程已经结束,则为
true。 - 如果该生成器函数还能产生更多的值,则为
false。
value- : 下一个
yeild表达式生成的值。
- : 下一个
示例
使用 throw()
以下示例展示了一个简单生成器和使用 throw 方法抛出的错误。像往常一样,错误可以通过 {{jsxref("Statements/try...catch", "try...catch")}} 块捕获。
// 异步任务。假设它在实践中做了一些更有用的事情。
function sleep(time) {
return new Promise((resolve, reject) => {
setTimeout(resolve, time);
});
}
async function* createAsyncGenerator() {
while (true) {
try {
await sleep(500);
yield 42;
} catch (e) {
console.error(e);
}
}
}
const asyncGen = createAsyncGenerator();
asyncGen.next(1).then((res) => console.log(res)); // { value: 42, done: false }
asyncGen
.throw(new Error("出了点问题")) // Error: 出了点问题
.then((res) => console.log(res)); // { value: 42, done: false }