简介
co-timeout 是一个 Node.js 的模块，旨在延时执行 Promise 对象的封装。该模块使用了 ES6 的 Generator 和 co 这个库来简化异步调用的流程。该模块提供了 Promise 对象的超时处理功能，可以方便地在代码中添加对超时的处理。
安装
在项目中使用 npm 来安装该模块：
npm install co-timeout
使用
基本用法
使用 co-timeout 要求 Node.js 版本需要大于等于 0.12。在 Node.js 中引入该模块，并调用 coTimeout 方法即可进行延时操作：
-- -------------------- ---- ------- ----- -- - -------------- ----- --------- - ---------------------- ------------ -- - ------------------- -------- ----- ---------------- ------------------ -------- ---------------------- - ------------------------- ---
在上述代码中，我们首先引入了 co 和 co-timeout 两个模块，并使用 ES6 的 Generator 语法来实现异步操作。在这个 Generator 函数中，我们依次输出了 before sleep 和 after sleep。在中间我们使用了 coTimeout 延时了 1000ms，来模拟异步处理的时间。最后我们使用了 catch 函数来捕获错误。
如果不使用 coTimeout，那么我们需要引入 Node.js 的 setTimeout 函数，并包装成 Promise。使用 coTimeout 更加方便和简单。
超时处理
coTimeout 方法接受两个参数，第一个参数是需要延时的时间，单位是毫秒。第二个参数是可选的超时错误信息，可以是字符串或者 Error 对象。如果在超时时间到期之前操作没有完成，那么会抛出这个错误。代码示例：
co(function* () {
console.log('before sleep');
yield coTimeout(1000, new Error('timeout'));
console.log('after sleep');
}).catch(function(err) {
console.error(err.stack);
});在上述代码中，我们在 coTimeout 中加入了超时错误信息。如果该操作在 1000ms 内未完成，那么会直接抛出这个错误，而不会执行 console.log('after sleep');。如果不加入超时错误信息，那么错误会默认为 Promise.race 中第一个 reject 的错误。
如果操作在超时时间内完成
如果我们希望在操作在超时时间内完成的情况下，不抛出错误并且继续执行后续的操作，那么可以在 coTimeout 中传递 true 作为第三个参数：
co(function* () {
console.log('before sleep');
yield coTimeout(1000, new Error('timeout'), true);
console.log('after sleep');
}).catch(function(err) {
console.error(err.stack);
});在上述代码中，我们在 coTimeout 中最后添加了第三个参数，用来标识在超时时间内完成操作的情况下，是否需要抛出错误。如果该参数为 false 或者不传递，那么在超时时间内完成操作后，也会抛出错误。
结语
使用 co-timeout 可以为异步代码添加超时处理，提高程序的容错性。在使用该模块的过程中，我们要注意超时时间的设置，以及数据是否正确返回，避免因为超时而导致错误结果的输出。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5eedc6f6b5cbfe1ea061227e