tcp ping sync

TCP-PING同步

具有同步API的TCP ping实用程序
⌛⇄

安装

npm i tcp-ping-sync

用法

该库揭示了两种方法： ping和probe ：

 const { ping , probe } = require ( 'tcp-ping-sync' ) ;

const response = ping ( { host : 'google.com' , port : 443 } ) ;
console . log ( response ) ;
// {
//   results: [
//     { seq: 0, time: 126.462211 },
//     { seq: 1, time: 113.164184 },
//     { seq: 2, time: 132.048925 },
//     { seq: 3, time: 148.315887 },
//     { seq: 4, time: 137.088763 },
//     { seq: 5, time: 105.050291 },
//     { seq: 6, time: 105.028794 },
//     { seq: 7, time: 109.297229 },
//     { seq: 8, time: 102.262321 },
//     { seq: 9, time: 112.281641 }
//   ],
//   stats: {
//     min: 102.26232,
//     avg: 119.10002450000002,
//     max: 148.315887,
//     stddev: 15.019185518208955
//   },
//   settings: {
//     host: 'google.com',
//     port: 443,
//     attempts: 10
//   }
// }

const isGoogleReachable = probe ( 'google.com' ) ;
console . log ( isGoogleReachable ) ;
// true

API

 const { ping , probe } = require ( 'tcp-ping-sync' ) ;

// Probe (does a single ping attempt succeed?)

const isRemoteReachable = probe (
  ( host = String ) , //   (default: 'localhost')
  ( port = Number ) //    (default: 80)
) ;

const isLocalReachable = probe (
  ( port = Number ) //    (default: 80)
) ;

// Ping

const {
  results = [
    {
      seq : Number , //   Sequence [0...attempts-1]
      time : Number //   Response time
    }
    // ...
  ] ,
  stats = {
    min : Number , //     Fastest response time
    max : Number , //     Slowest response time
    avg : Number , //     Average response time
    stddev : Number //   Standard deviation
  } ,
  settings : Object //   Resolved arguments (host, port & attempts)
} = ping ( {
  host : String , //      Hostname/IP address   (default: 'localhost')
  port : Number , //      Port number           (default: 80)
  attempts : Number //   Number of attempts   (default: 10)
} ) ;

可以在测试（ test.js ）中找到更多用法示例，可以通过npm test运行。要使用调试输出执行测试，请运行npm run test:debug 。

警告

该库具有可选的依赖关系（NetLinkWrapper），需要编译本机模块。如果您的平台无法编译，则将使用替代方案（但较慢）的依赖性。在这种情况下，只有在您确实需要同步响应时，才应该考虑使用此库。如果异步是可以接受的，则可能需要使用tcp-ping 。

学分

这项工作的灵感来自亚当·帕斯克（Adam Paszke）的tcp-ping （MIT;©2014）。还要感谢Jacob Fischer研究了如何模拟节点中的同步网络插座并将解决方案作为同步插座实现。