Kill-9 NPM | npm.io

kill-9

a way to kill node process from client navigator. Something like http://yoursite.kom/kill-9

language: English also available in:

Install

$ npm install kill-9

Use it in the client navigator

use kill-9 as a url in the navigator

API

var express = require('express');
var app = express();

var kill9 = require('kill-9');

var server = app.listen(3000, function() {
    console.log('Listening on port %d', server.address().port);
});

app.use(kill9({log:true}));

// complete example:
function site_up(req,res){
    var kill_url='kill-9?pid='+process.pid;
    res.send("<h1>kill-9 demo</h1><p>site up<p>try <a href="+kill_url+">"+kill_url+"</a>");
}

app.get('/index.html',site_up);
app.get('/',site_up);

kill9(options)

Returns a function middleware to use with express.use. Once installed you can kill the process typing "kill sentence" in the navigator.

Example:

http://thesite.kom/kill-9?pid=12345

option	type	default value	details
statement	text	"kill-9"	The statement that you must type in the url.
pid	integer	process.pid	The pid value that you must pass in the pid parameter. By default kill-9 uses the real pid obteined from `pid` property of `process` object: `process.pid`
log	boolean	false	If log is set kill-9 show a console.log when it is installed. You can send true or a message.
statusKilled	integer	200	The status sent in the response for the case of success.
location	url		The location for a redirect. This is mandatory if statusKilled between 300 and 303.
messageKilled	text	"kill -9 success"	The message to display in successful kills.
statusBad	integer	404	The status sent when the pid doesn't match.
locationBad	url		The location for a redirect. This is mandatory if statusKilled between 300 and 303.
messageBad	text	"kill -9 unknown"	The message to display when when the pid doesn't match.
process	object	process	The process option is for test purpose. You can pass a mock object.

app.use(kill9({log:"remember to delete in production"}));

// Supose that exists getMode(). This is better
if(getMode()=='develop'){
    app.use(kill9({log:true}));
}

app.use(kill9({statusKilled:301, location:'other_site.kom'}));

app.use(kill9({messageKilled: "I'll be back"}));

app.use(kill9({messageBad: "Not foud"}));

function ProcessMock(){
    this.pid=444;
    this.codeRecived=null;
    this.exit=function(code){
        this.codeRecived=code;
    }
}

var pm=new ProcessMock();
test_app.use(
    kill9({process:pm})
).get(
    'kill-9?pid=444'
).then(function(){
    assert.equal(mp.codeRecived, 444);
});

Notes

This is not secure in production servers. Use it only in developer servers. Kill-9 lacks of password or validate user or any way for confirm legal use.
Actually options.pid can be a text, but I don't know if this will change in the future.