猿变实验室之猿变开发手册-NodeJS手册-Timers 计时器

Timers 计时器

setTimeout(callback, delay, [arg], [...])

设置延时delay 毫秒之后执行回调函数(callback)。该函数返回timeoutId，可以使用clearTimeout()清除定时。你也可以传递额外的参数给回调函数。

clearTimeout(timeoutId)

清除指定的定时。

setInterval(callback, delay, [arg], [...])

设置重复延时调用callback。该函数返回intervalId，可以使用clearTimeout()清除定时。你也可以传递可选的参数给回调函数。

.end(); clearInterval(intervalId)

清楚指定的重复延时回调。

Child Processes 子进程

node 通过ChildProcess 类提供全面的popen(3)功能。程序可以通过子进程的标准输入(stdin)、标准输出(stdout)、标准错误输出(stderr)以完全非阻塞的形式传递数据。

你可以使用require('child_process').spawn()创建子进程。每个子进程总是带有三个流对象：child.stdin, child.stdout 和child.stderr。每个ChildProcess 类也是一个事件触发器。

Event: 'exit'

function (code, signal) {}```

此事件在子进程结束后被触发。如果进程正常结束，code 参数的值就是子进程退出后的返回值，否则此参数为
null。如果进程因为信号而终止，参数signal 就是信号的名称，否则此参数为null。
触发此事件之后，node 将不再触发'output'和'error'事件。
See waitpid(2).


**child.stdin**


可写流(Writable Stream)，代表子进程的标准输入(stdin)。使用end()函数关闭此流(stream)，通常会终止子进程。

**child.stdout**


只读流(Readable Stream)，代表子进程的标准输出(stdout)。
**child.stderr**


只读流(Readable Stream)，代表子进程的标准错误输出(stderr)。


**child.pid**


子进程的PID
Example:

var spawn = require('child_process').spawn, grep = spawn('grep', ['ssh']); console.log('Spawned child pid: ' + grep.pid); grep.stdin.end();```

child_process.spawn(command, args=[], [options])

使用指定的命令行参数创建新线程。如果不指定参数，args 默认为空数组。第三个参数用于指定一些额外的选项，默认值如下：

{ cwd: undefined
, env: process.env,
, customFds: [-1, -1, -1]
}```

cwd 可以用于指定新进程的工作目录，env 指定新进程可见的环境变量，而customFds 则可以将新进程的
[stdin,stdout,stderr]绑定到指定的流，-1指创建新的流。


例子：执行命令'ls -lh /usr'并捕获标准输出、标准错误输出和退出代码（程序退出时，main 函数返回的代码）。

var sys = require('sys'),
spawn = require('child_process').spawn,
ps = spawn('ps', ['ax']),
grep = spawn('grep', ['ssh']);
ps.stdout.on('data', function (data) {
grep.stdin.write(data);
});
ps.stderr.on('data', function (data) {
sys.print('ps stderr: ' + data);
});
ps.on('exit', function (code) {
if (code !== 0) {
console.log('ps process exited with code ' + code);
}
grep.stdin.end();
});
grep.stdout.on('data', function (data) {
sys.print(data);
});
grep.stderr.on('data', function (data) {
sys.print('grep stderr: ' + data);
});
grep.on('exit', function (code) {
if (code !== 0) {
console.log('grep process exited with code ' + code);
}
});```

例子，检测退出代码：

var spawn = require('child_process').spawn, child = spawn('bad_command'); child.stderr.on('data', function (data) { if (/^execvp()/.test(data.asciiSlice(0,data.length))) { console.log('Failed to start child process.'); } });```

请参见：child_process.exec()

child_process.exec(command, [options], callback)

使用子进程执行命令，缓存子进程的输出，并将子进程的输出以回调函数参数的形式返回。

var sys = require('sys'),
exec = require('child_process').exec,
child;
child = exec('cat *.js bad_file | wc -l',
function (error, stdout, stderr) {
sys.print('stdout: ' + stdout);
sys.print('stderr: ' + stderr);
if (error !== null) {
console.log('exec error: ' + error);
}
});```

回调函数得到的参数分别为(error, stdout, stderr)。成功时error 参数是null；失败时error 参数是Error 的实例。
error.code 是子进程的返回值，error.signal 保存终止进程的信号。
exec 函数的第二个可选参数可以用来指定一些选项。默认值为

{ encoding: 'utf8' , timeout: 0 , maxBuffer: 200*1024 , killSignal: 'SIGKILL' , cwd: null , env: null }```

如果timeout 为大于0的值，node 将终止运行时间超过timeout（单位为毫秒）的子进程。子进程将被终止信号 (killSignal，默认值为'SIGKILL')终止。maxBuffer 指定stdout 和stderr 最大可缓存数据的大小，如果超过这个值子进程将被终止。

child.kill(signal='SIGTERM')

向子进程发送信号。如果不指定参数，默认发送'SIGTERM'信号。所有可用信号列表请参考signal(7)。 var spawn = require('child_process').spawn, grep = spawn('grep', ['ssh']); grep.on('exit', function (code, signal) { console.log('child process terminated due to receipt of signal '+signal); }); // send SIGHUP to process grep.kill('SIGHUP');

注意，虽然此函数名为kill，但发送的信号不一定终止子进程。kill 实际上只会向进程发送信号。 See kill(2) 更多信息请参考kill(2)

Timers 计时器

Child Processes 子进程

讨论区