tcp ping sync

TCP-Ping-Sync

Утилита Ping TCP с синхронным API
⌛⇄

Установить

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 ) можно найти больше примеров использования (test.js), которые можно запустить с помощью npm test . Чтобы выполнить тесты с выводом отладки, запустите npm run test:debug .

Предупреждение

Эта библиотека имеет дополнительную зависимость (NetLinkWrapper), которая должна компилировать собственные модули. Если ваша платформа не может составить ее, будет использоваться альтернативная (но медленная) зависимость. В этом случае вы должны рассмотреть возможность использования этой библиотеки, только если вам действительно нужен синхронный ответ. Если Async является приемлемым, вы, вероятно, захотите использовать tcp-ping .

Кредиты

Эта работа вдохновлена tcp-ping Адама Пашке (MIT; © 2014). Также спасибо Джейкобу Фишеру за то, что выяснили, как смоделировать синхронные сетевые розетки в узле и реализовать решение в качестве синхронизации.