url-keeper
v1.2.1
Published
Dynamically maintains a list of URLs based on their availability in a given time interval. You can also add or remove an URL on the fly. Uses url-monitor and event-timer.
Downloads
2
Maintainers
Readme
url-keeper
Dynamically maintains a list of URLs based on their availability in a given time interval. You can also add or remove a URL on the fly. Uses url-monitor and event-timer.
Installation
npm install url-keeper
How to
Here a simple example with the 'change' event, in fact a timer based on interval option, which gives you a Javascript Object with detailed informations (http status codes, status, last checked time) :
// Load module
var urlkeeper = require('./url-keeper.js');
// create url-keeper instance
var monitor = new urlkeeper({
interval: 5000, // 5000 ms by default, optional
timeout: 3000, // 3000 ms by default, optional
list:['http://www.google.fr', // Mandatory
'http://www.microsoft.com',
'http://www.apple.com',
'https://www.debian.org']
});
// Timer which refreshes results on time interval
monitor.on('change', (data) => {
console.dir(data,{colors: true});
})
// Add an url
monitor.add('http://www.npmjs.com');
// Start url-keeper
monitor.start();
The results given by the 'change' event will be :
{
'http://www.google.fr': {
code: 200,
status: 'available',
time: 1462138566961
},
'http://www.microsoft.com': {
code: 200,
status: 'available',
time: 1462138566917
},
'http://www.apple.com': {
code: 200,
status: 'available',
time: 1462138567049
},
'https://www.debian.org': {
code: 200,
status: 'available',
time: 1462138567341
},
'http://www.npmjs.com': {
code: 301,
status: 'available',
time: 1462138567062
}
}
If you want to manage the refresh of the list by yourself without the 'change' event, you can access the list with this method (but the interval option is always necessary for URL checking) :
// create url-keeper instance
var monitor = new urlkeeper({
eventTimer: 'false', // 'true' by default, optional
list:['http://www.google.fr', // Mandatory
'http://www.microsoft.com',
'http://www.apple.com',
'https://www.debian.org']
});
monitor.start();
monitor.getList();
You can get an array of the URLs (for an example, to get the updated list passed at origin in the options before stopping the instance) :
monitor.getURLs();
Or an array of the available URLs :
monitor.getAvailableURLs();
You can add or delete an url to the list on the fly :
monitor.add('https://my.secure.site');
monitor.del('https://my.secure.site');
If you want to know if url-keeper is running (returns 'true' or 'false'):
monitor.isRunning();
To stop url-keeper:
monitor.stop();
Updates
v1.2.1 :
Updating dependenciesv1.2.0 :
Add 'getAvailableURLs()' method and 'eventTimer' optionv1.0.1 :
Removes an old reference to an unused modulev1.0.0 :
Initial release
License
The MIT License (MIT) Copyright (c) 2016 Julien Blanc