node-port-scanner

Lean JavaScript port scanner for open/closed ports

Usage no npm install needed!

<script type="module">
  import nodePortScanner from 'https://cdn.skypack.dev/node-port-scanner';
</script>

README

node-port-scanner

npm

node-port-scanner

Scans ports to see if they are open or closed.

After calling nodePortScanner, ports are checked in order one after the previous is completed.

Multiple calls can be made and will run in parallel.

Install

npm i node-port-scanner

Usage

npm run usage
const nodePortScanner = require('node-port-scanner');

// scan local common ports
nodePortScanner('127.0.0.1', [21, 22, 23, 25, 80, 110, 123, 443])
  .then(results => {  
    console.log(results);
  })
  .catch(error => {
    console.log(error);
  });

// scan remote common ports
nodePortScanner('github.com', [21, 22, 23, 25, 80, 110, 123, 443])
  .then(results => {  
    console.log(results);
  })
  .catch(error => {
    console.log(error);
  });

// scan all local ports - not recommended on remote hosts
async function checkLocalPorts () {
  
  const allPorts = nodePortScanner('127.0.0.1', []);
  console.log(await allPorts);
  
}
checkLocalPorts();

Sample Response

{
  host: 'github.com',
  ports: { 
    open: [ 22, 80, 443 ], 
    closed: [ 21, 23, 25, 110, 123 ] 
  }
}

Test (Jest)

npm test

License (MIT)

MIT