本文是对nodejs0.8.8版本的api开发手册解读.nodejs网址
进程(process)
process对象是一个全局对象,它可以在任何地方被访问.它是一个EventEmitter对象的实例.
Event:'exit'
当一个进程即将退出时放出'exit'事件,这一个用来定时检查模块的状态的好钩子(hook)(例如单元测试),当主事件循环在执行完'exit'的回调函数后将不再执行,所以在exit事件中定义的定时器可能不会被加入事件列表.
监听'exit'事件的例子:
process.on('exit', function () {
process.nextTick(function () {
console.log('This will not run');
});
console.log('About to exit.');
});
Event:'uncaughtException'
当一个异常冒泡循环一圈又回到node事件循环时放出'uncaughtException'.如果这个异常被添加了一个监听器,默认操作(打印堆栈信息并退出)将不会执行.
监听'uncaughtException'事件的例子:
process.on('uncaughtException', function (err) {
console.log('Caught exception: ' + err);
});
setTimeout(function () {
console.log('This will still run.');
}, 500);
// Intentionally cause an exception, but don't catch it.
nonexistentFunc();
console.log('This will not run.');
注意:uncaughtException是一个很低级的异常处理,在将来可能被移除.
不要使用它,用domains代替(后面会讲),如果你非用不可,只好每次在程序发生异常之后重启.
不要把它和'On Error Resume Next'一起用,因为一个未处理的异常意味着你的程序--甚至是node.js自己--在一个未定义的状态.盲目的恢复继续执行疑问这任何事都可能发生.
想像一下,在你正在升级你的系统的时候拉扯主机电源线,十有八九可能什么都不会发生--但是第十次,你的系统会瘫痪.
你已经被警告过了.
信号事件(signal Events)
当进程接受到一个信号时发出'singal'事件.可以使用sigaction(2)(linux系统下)查看标准的posix 信号命名列表,例如:SIGINT,SIGUSR1,等等.
监听'signal'事件的例子:
// Start reading from stdin so we don't exit.
process.stdin.resume();
process.on('SIGINT', function () {
console.log('Got SIGINT. Press Control-D to exit.');
});
一个简单的方式发送SIGINT信号的方法是:control-c,在大多是终端程序里.
process.stdout
一个可以写道stdout的流
例子:console.log的定义:
console.log = function (d) {
process.stdout.write(d + '\n');
};
process.stderr和process.stdout在node中是和其他流不一样在往这些流里写东西时是阻塞的.这些阻塞的流需要索引常规文件或者tty文件描述.而process.stderr和process.stdout是索引管道,他们不像其他流一样阻塞.
process.stdin
标准输入流是一个可读的流,stdin流默认是暂停状态,所以想要从stdin读取必须要调用一次process.stdin.resume();
打开stdin和监听两个事件的例子:
process.stdin.resume();
process.stdin.setEncoding('utf8');
process.stdin.on('data', function (chunk) {
process.stdout.write('data: ' + chunk);
});
process.stdin.on('end', function () {
process.stdout.write('end');
});
process.argv
一个包含命令行参数的数组.第一个元素将会是"node",第二个参数将会是一个javascript文件的名字,后面的元素将会是一些附加的命令行参数.
// print process.argv
process.argv.forEach(function (val, index, array) {
console.log(index + ': ' + val);
});
这将会产生:$ node process-2.js one two=three four
0: node
1: /Users/mjr/work/node/process-2.js
2: one
3: two=three
4: four
process.execPath
这是启动进程的可执行程序的绝对路径.
例子:
/usr/local/bin/node
process.abort()
这将引起node发出一个abort事件,将会引起node退出并生成一个核心文件.
process.chdir(directory)
改变当前进程的工作目录,如果失败会放出一个异常.
console.log('Starting directory: ' + process.cwd());
try {
process.chdir('/tmp');
console.log('New directory: ' + process.cwd());
}
catch (err) {
console.log('chdir: ' + err);
}
process.cwd()
返回当前进程的工作目录.
console.log('Current directory: ' + process.cwd());
process.env
一个包含了用户的环境变量的对象,可以用eviron(7)查看详细(Linux下)
process.exit([code])
用指定的code结束进程,如果省略了code,就会使用'success'code 0.
用'failure'代码退出:
process.exit(1);
在shell下可以看见node的退出代码1(我在window下没看见).
process.getgid()
注意:这个函数支持posix平台,不支持windows平台.
获得进程的组id,(getgid(2)查看详细),这是一个数组组id,不是组名称.
if (process.getgid) {
console.log('Current gid: ' + process.getgid());
}
process.setgid()
注意:这个函数支持posix平台,不支持windows平台.
设置进程的组id,可以接受一个数字id或者一个组名称字符串.如果一个组名称被指定,这个方法在通过给定的组名称解析出数字id之前是阻塞的.
if (process.getgid && process.setgid) {
console.log('Current gid: ' + process.getgid());
try {
process.setgid(501);
console.log('New gid: ' + process.getgid());
}
catch (err) {
console.log('Failed to set gid: ' + err);
}
}
process.getuid()
注意:这个函数支持posix平台,不支持windows平台.
获得线程的用户id,这是一个数字id,不是一个用户名.
if (process.getuid) {
console.log('Current uid: ' + process.getuid());
}
process.setuid()
注意:这个函数支持posix平台,不支持windows平台.
设置线程的用户id,可以接受一个数字id或者一个组名称字符串.如果一个组名称被指定,这个方法在通过给定的组名称解析出数字id之前是阻塞的.
if (process.getuid && process.setuid) {
console.log('Current uid: ' + process.getuid());
try {
process.setuid(501);
console.log('New uid: ' + process.getuid());
}
catch (err) {
console.log('Failed to set uid: ' + err);
}
}
process.version
一个内编译的属性,把NODE_VERSION属性暴漏了出来.
console.log('Version: ' + process.version);
这个属性曝露出了node和node的依赖库的版本.
console.log(process.versions);
将会输出:{ node: '0.4.12', v8: '3.1.8.26', ares: '1.7.4', ev: '4.4', openssl: '1.0.0e-fips' }
process.config
这个对象代表了我们用来编译当前node的可执行程序的配置信息的javascript描述.这和我们运行./configure时生成的'config.gypi'一样.
一个输出的例子大概是:
{ target_defaults:
{ cflags: [],
default_configuration: 'Release',
defines: [],
include_dirs: [],
libraries: [] },
variables:
{ host_arch: 'x64',
node_install_npm: 'true',
node_install_waf: 'true',
node_prefix: '',
node_shared_v8: 'false',
node_shared_zlib: 'false',
node_use_dtrace: 'false',
node_use_openssl: 'true',
node_shared_openssl: 'false',
strict_aliasing: 'true',
target_arch: 'x64',
v8_use_snapshot: 'true' } }
process.kill(pid,[signal])
发送一个信号到进程.pid是进程id,参数signal是要发送信号的一个字符串描述.信号的命名看起来像:'SIGINT'or'SIGINT1'.如果省略signal参数,将默认是:'SIGTERM',可以用kill(2)查看更多信息.
注意,正因为名字是process.kill,它确实只是一个信号发送器.就像系统调用call一样.发送的信号,可能除了杀死进程外还要做其他一些事情.
给自己发送一个进程的例子:
process.on('SIGHUP', function () {
console.log('Got SIGHUP signal.');
});
setTimeout(function () {
console.log('Exiting.');
process.exit(0);
}, 100);
process.kill(process.pid, 'SIGHUP');
process.pid
进程的pid属性.
console.log('This process is pid ' + process.pid);
process.title
设置或者获取在使用ps命令时显示的名称.
process.arch
你正在使用的处理器类型,例如:'arm','ia32'or'x64'.
console.log('This processor architecture is ' + process.arch);
process.platform
你正在使用的平台,例如:'darwin','freebsd','linux','solaris'or'win32'.
console.log('This platform is ' + process.platform);
process.memoryUsage()
返回一个node通过bytes测试的内存用法的表述的对象.
var util = require('util');
console.log(util.inspect(process.memoryUsage()));
例如:{ rss: 4935680, heapTotal: 1826816, heapUsed: 650472 }
process.nextTick(callback)
在事件循环的下次循环中执行callback.这不是一个简单的setTimeout(fn,0)的别名.它的效率要高很多.
process.nextTick(function () {
console.log('nextTick callback');
});
process.umask([mask])
设置或者读取线程的文件模式创建掩码(屏蔽字).子进程从父进程继承掩码.如果是设置操作,将返回原先的mask,如果是读取,返回当前的mask.
var oldmask, newmask = 0644;
oldmask = process.umask(newmask);
console.log('Changed umask from: ' + oldmask.toString(8) +
' to ' + newmask.toString(8));
process.uptime()
返回一个数字,代表当前node已经运行的时间.
process.hrtime()
返回一个[秒,纳秒]形式的数组,代表了当前实时最高分标率.返回结果和过去的时间有关,和天数没有关系,因此没有对象记录偏移量.最初用于测量interval之间的效果.
你可以传入上次process.hrtime()返回的结果到process.hertime()中,得到一个不一样的结果.用来测量基准点和interval很有用.
var t = process.hrtime();
// [ 1800216, 927643717 ]
setTimeout(function () {
t = process.hrtime(t);
// [ 1, 6962306 ]
console.log('benchmark took %d seconds and %d nanoseconds', t[0], t[1]);
// benchmark took 1 seconds and 6962306 nanoseconds
}, 1000);