repl即node自带的交互式解释器,它可以实现如下的任务:
稳定性: 3 - 稳定read-eval-print-loop (repl 读取-执行-输出循环)即可作为独立程序,也可以集成到其他程序中。
repl提供了一种交互的执行javascript并查看输出结果的方法。可以用来调试,测试,或仅是用来试试。
在命令行中不带任何参数的执行node,就是repl模式。它提供了简单的emacs行编辑。
mjr:~$ node
type '.help' for options.
> a = [ 1, 2, 3];
[ 1, 2, 3 ]
> a.foreach(function (v) {
... console.log(v);
... });
1
2
3若想使用高级的编辑模式,使用环境变量node_no_readline=1打开node。这样会开启repl模式,允许你使用rlwrap。
例如,你可以添加以下代码到你的bashrc文件里。
alias node="env node_no_readline=1 rlwrap node"启动并返回一个replserver实例。它继承自[readline interface][]。接收的参数"options"有以下值:
prompt- 所有输入输出的提示符和流,默认是>.
input- 需要监听的可读流,默认为process.stdin.
output- 用来输出数据的可写流,默认为process.stdout.
terminal- 如果stream被当成tty,并且有ansi/vt100转义,传输true。默认在实例的输出流上检查istty。
eval- 用来对每一行进行求值的函数。默认为eval()的异步封装。参见后面的自定义eval例子。
usecolors- 写函数输出是否有颜色。如果设定了不同的writer函数则无效。默认为 repl 的terminal值。
useglobal- 如果为true,则repl将会使用全局对象,而不是在独立的上下文中运行scripts。默认为false。
ignoreundefined- 如果为true,repl不会输出未定义命令的返回值。默认为false。
writer- 每个命令行被求值时都会调用这个函数,它会返回格式化显示内容(包括颜色)。默认是util.inspect。如果有以下特性,可以使用自己的eval函数:
function eval(cmd, context, filename, callback) {
callback(null, result);
}在同一个node的运行实例上,可以打开多个repls。每个都会共享一个全局对象,但会有独立的i/o。
以下的例子,在stdin、 unix socket和 tcp socket上开启repl :
var net = require("net"),
repl = require("repl");
connections = 0;
repl.start({
prompt: "node via stdin> ",
input: process.stdin,
output: process.stdout
});
net.createserver(function (socket) {
connections += 1;
repl.start({
prompt: "node via unix socket> ",
input: socket,
output: socket
}).on('exit', function() {
socket.end();
})
}).listen("/tmp/node-repl-sock");
net.createserver(function (socket) {
connections += 1;
repl.start({
prompt: "node via tcp socket> ",
input: socket,
output: socket
}).on('exit', function() {
socket.end();
});
}).listen(5001);从命令行运行这个程序,将会在stdin上启动repl。其他的repl客户端可能通过unix socket或tcp socket连接。telnet常用于连接tcp socket,socat用于连接unix和tcp sockets
从unix socket-based服务器启动repl(而非stdin),你可以建立长连接,不用重启它们。
通过net.server和net.socket实例运行"full-featured" (terminal) repl的例子,参见: https://gist.github.com/2209310
通过curl(1)实例运行repl的例子,参见: https://gist.github.com/2053342
function () {}
当用户通过预定义的方式退出repl将会触发这个事件。预定义的方式包括,在repl里输入.exit,按ctrl+c两次来发送sigint信号,或者在input流上按ctrl+d 来发送"end"。
监听exit的例子:
r.on('exit', function () {
console.log('got "exit" event from repl!');
process.exit();
});function (context) {}
重置repl的上下文的时候触发。当你输入.clear会重置。如果你用{ useglobal: true }启动repl,那这个事件永远不会被触发。
监听reset的例子:
// extend the initial repl context.
r = repl.start({ options ... });
someextension.extend(r.context);
// when a new context is created extend it as well.
r.on('reset', function (context) {
console.log('repl has a new context');
someextension.extend(context);
});在repl里, control+d会退出。可以输入多行表达式。支持全局变量和局部变量的tab自动补全。
特殊变量_(下划线)包含上一个表达式的结果。
> [ "a", "b", "c" ]
[ 'a', 'b', 'c' ]
> _.length
3
> _ += 1
4repl支持在全局域里访问任何变量。将变量赋值个和replserver关联的上下文对象,你可以显示的讲变量暴露给repl,例如:
// repl_test.js
var repl = require("repl"),
msg = "message";
repl.start("> ").context.m = msg;context对象里的东西,会以局部变量的形式出现:
mjr:~$ node repl_test.js
> m
'message'有一些特殊的repl命令:
.break - 当你输入多行表达式时,也许你走神了或者不想完成了,.break可以重新开始。 .clear - 重置context对象为空对象,并且清空多行表达式。 .exit - 关闭输入/输出流,会让repl退出。.help - 打印这些特殊命令。.save - 保存当前repl会话到文件。.save ./file/to/save.js
.load- 加载一个文件到当前repl会话.load ./file/to/load.js
下面的组合键在repl中有以下效果:
<ctrl>c- 和.break键类似,在一个空行连按两次会强制退出。<ctrl>d- 和.exit键类似。