tcp ping sync

TCP-Ping-Sync

TCP Ping Utility مع واجهة برمجة تطبيقات متزامنة
⌛⇄

ثَبَّتَ

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) التي تحتاج إلى تجميع الوحدات الأصلية. إذا فشل النظام الأساسي في تجميعه ، فسيتم استخدام التبعية البديلة (ولكن أبطأ). في هذه الحالة ، يجب عليك التفكير فقط في استخدام هذه المكتبة إذا كنت بحاجة حقًا إلى استجابة متزامنة. إذا كانت ASYNC مقبولة ، فربما تريد استخدام tcp-ping بدلاً من ذلك.

الاعتمادات

هذا العمل مستوحى من tcp-ping 's Adam Paszke (MIT ؛ © 2014). شكرًا أيضًا لـ Jacob Fischer على تحديد كيفية محاكاة مآخذ الشبكة المتزامنة في العقدة وتنفيذ الحل كمقبس المزامنة.