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研究瞭如何模擬節點中的同步網絡插座並將解決方案作為同步插座實現。