在前端开发过程中，我们经常需要对网络中的设备和端口进行扫描和检测。这时候，npm 包 @croqaz/port-scan 便能很好地满足开发者的需求。本文将详细介绍该包的使用方法、原理和示例。
包的安装
可以在终端中使用以下命令安装 @croqaz/port-scan：
npm install @croqaz/port-scan
若使用 yarn，则可以执行以下命令：
yarn add @croqaz/port-scan
包的使用
使用该包进行端口扫描需要实例化 PortScanner 类，然后设置扫描目标并执行扫描。示例代码如下：
-- -------------------- ---- ------- ----- - ----------- - - ----------------------------- ----- ------- - --- -------------- ------------------------------ ---- ------------------------------- -- - ----------------------- ---
上述代码中，我们实例化了 PortScanner 类并设置扫描目标为 127.0.0.1 的 80 端口。然后执行 scan() 方法开始扫描，该方法会返回一个 Promise 对象，在 Promise 对象中，我们可以获得扫描结果：包含开放端口的数组。
除了 addTarget() 方法外，PortScanner 类还提供了以下方法：
setPortsRange(startPort: number, endPort: number)
设置扫描的端口范围。缺省情况下，包只扫描 1-65535 端口。
setThreads(numThreads: number)
设置并行扫描的线程数量，默认为 10 个线程。
setTimeout(timeout: number)
设置连接超时的时间，默认为 5000ms。
包的原理
@croqaz/port-scan 的原理是，通过使用 Node.js 的 net 模块、域名解析、Promise 和 Event Emitter 等特性，实现了一个简单并行的端口扫描器。
在执行 scan() 方法的时候，该函数会分配扫描任务到多个线程中，并对每个线程执行扫描任务。每个扫描任务会先进行 DNS 解析，得到 IP 地址后，尝试连接该 IP 的某个端口。如果连接成功，任务会将该端口标记为开放，并向 EventEmitter 发送开启端口事件。
当所有线程执行完毕之后，主线程会根据所有开启端口的事件，组合出开放端口的数组并 resolve Promise 对象。
结束语
@croqaz/port-scan 是一个功能强大、易于使用的 npm 包。本文介绍了其的基本使用方法，使用者可以根据自己的需要在实际开发中使用。若想了解更多详细的使用说明和 API 文档，可以参考官方文档 https://www.npmjs.com/package/@croqaz/port-scan。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600572c481e8991b448e8e04