在Web开发中，我们经常需要在代码中设置一些超时时间，比如请求某个API或等待异步操作完成等。在Node.js中，我们可以使用setTimeout函数来实现这个功能。然而，手动设置超时时间并不是一个好的做法，因为它会增加代码的复杂性并且容易出错。为了避免这个问题，我们可以使用一个名为 @theos/timed-out 的npm包，它提供了一种简单而方便的方式来设置超时时间。
什么是@theos/timed-out？
@theos/timed-out是一个Node.js模块，它提供了一种简单的机制来设置请求超时时间。它可以与任何HTTP请求库一起使用，例如Node.js内置的http和https模块，以及request和axios等第三方请求库。
它的主要特点包括：
- 轻量级且易于使用：
@theos/timed-out模块只有一个函数，可以轻松地将其添加到任何项目中。 - 具有适应性:
@theos/timed-out可以与各种请求库一起使用，因此您可以使用自己喜欢的请求库。 - 可自定义超时时间：您可以根据需要自定义超时时间。
- 高效：
@theos/timed-out执行效率高，不会对应用性能产生负面影响。
安装@theos/timed-out
在使用@theos/timed-out之前，您需要先安装它。您可以使用NPM来安装它，也可以使用Yarn。假设您正在使用NPM，请在终端中运行以下命令：
npm install @theos/timed-out
如果您使用Yarn，请使用以下命令：
yarn add @theos/timed-out
如何使用 @theos/timed-out
现在，让我们通过编写一个基本示例来了解如何使用@theos/timed-out。在此示例中，我们将使用Node.js内置的http模块来创建一个HTTP请求，并将超时时间设置为5秒。如果请求在5秒内未完成，@theos/timed-out会中止请求并引发一个错误。
-- -------------------- ---- -------
----- ---- - ----------------
----- ------- - ----------------------------
----- --- - --------------
--------- ------------
----- -----
----- -------
------- -----
---
----- ----- - ------------ ------ -- ---------
------------------- -- -- -
------------
--------------------
---
------------------ ----- -- -
-------------- ------ -- -
-----------------------------
---
------------- -- -- -
--------------------
---
---
----------在这个示例中，我们使用http.request方法来发起一个HTTP GET请求，并将超时时间设置为5秒。然后，我们使用@theos/timed-out的timeout函数来创建一个计时器，并将其与请求对象关联。当计时器超时时，timeout事件将被触发，我们将请求对象中止，以释放底层资源。
自定义超时时间
在默认情况下，@theos/timed-out的超时时间是2分钟。如果需要，您可以使用timeout函数提供的第二个参数来自定义超时时间。以下示例将超时时间设置为10秒：
const timer = timeout(req, 10000);
使用 timeoutWithSignal代替 timeout
如果正在运行的Node.js版本支持AbortSignal，则建议使用 timeoutWithSignal代替timeout函数。使用AbortSignal可以更好地支持取消请求操作。
以下示例将超时时间设置为30秒，并使用AbortSignal取消请求：
-- -------------------- ---- -------
----- ---- - ----------------
----- ------- - ----------------------------
----- ---------- - --- ------------------
----- ------ - ------------------
----- --- - --------------
--------- ------------
----- -----
----- -------
------- ------
------- ------
---
----- ----- - --------------------------------- -------
------------------- -- -- -
-------------------
--------------------
---
------------------ ----- -- -
-------------- ------ -- -
-----------------------------
---
------------- -- -- -
--------------------
---
---
----------总结
@theos/timed-out是一个非常有用的npm包，它提供了一个简单而方便的方式来设置超时时间来执行自己的操作。在使用它时，您可以自己决定超时时间，并选择自己喜欢的HTTP请求库。如果您还没有使用这个包，我们强烈建议您尝试使用它来提高您的Web开发效率和代码质量。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60056f3e81e8991b448e7972