Skip to content

Instantly share code, notes, and snippets.

Created June 22, 2009 05:02
Show Gist options
  • Save subtleGradient/133810 to your computer and use it in GitHub Desktop.
Save subtleGradient/133810 to your computer and use it in GitHub Desktop.
JavaScript Process API proposal

Process API

The ServerJS system api might help:

Ideally Titanium would stick as close to existing standards as much as possible.

All processes, like the current process, could have: environment, arguments, stdin, stdout & stderr.

When creating a process I'd like to be able to define a process, along with its environment and arguments. Then hook up the stdin, stdout & stderr to some sort of IO objects. If you don't define the objects yourself, they could instantiate STDIN, STDOUT & STDERR constructors which are subclasses of some kind of IO. EG:


  • string — The script to run. The script is parsed and converted into the args array.
  • object — Optional properties: env, args, stdin, stdout & stderr

Internally this could be the equivalent of the default when running new Process();

var myProcess = new Process({
	env: new Env(),
	args: new Args(),
	stdin: new STDIN(),
	stdout: new STDOUT(),
	stderr: new STDERR() 


Then you could be able to change each property manually before running the process.

myProcess.env = new Env();
myProcess.args = new Args();
myProcess.stdin = new STDIN();
myProcess.stdout = new STDOUT();
myProcess.stderr = new STDERR();

Once you run the process, trying to modify some things could throw an error.;
myProcess.args = []; // error

Access the properties at any time.



Add callback functions.

myProcess.stdinCallback = function(text){ this === myProcess; /* true */};
myProcess.stdoutCallback = function(text){ this === myProcess; /* true */};
myProcess.stderrCallback = function(text){ this === myProcess; /* true */};

Run Synchronously

Execute a process synchronously by calling it as a function.

var listHome = new Process('ls -lapsh ~/');
var home_list = listHome();

Execute the process multiple times. Doing so should reset the stdin, stdout & stderr before execution.

var home_list1 = listHome();

Run Asynchronously

Execute a process asynchronously by calling its run method.

var listHome = new Process({ args:['ls', '-lapsh', '~/'] });
var home_list = [];
listHome.stdoutCallback = function(text){
listHome.exitCallback = function(){
	home_list = home_list.join('\n');


Write to stdin.

myProcess.write('hello stdin');

Close stdin to further writes.


Sent the process signals.

myProcess.kill(); // same as myProcess.send(Process.SIGNAL_KILL);

Clone the process.

var myProcess2 = myProcess.clone(); // new process with cloned environment and arguments and new blank stdin, stdout & stderr
var myProcess2 = myProcess.clone(true); // new process with cloned environment, arguments, stdin, stdout & stderr
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment