eval5

中文 | English

基于 TypeScript 编写的 JavaScript 解释器，支持完整 ES5 语法

支持浏览器、node.js、小程序等 JavaScript 运行环境

在线体验

更多示例

使用场景

• 小程序不支持，特此修改
• 浏览器环境中需要使用沙盒环境执行 JavaScript 脚本
• 控制执行时长
• 不支持eval Func的 JavaScript 运行环境：如 微信小程序 demo we-script taro-script
• 研究/学习用

支持 ECMAScript 版本

ES5

安装

npm install --save eval5

使用

1import { Interpreter } from "eval5";
2
3const interpreter = new Interpreter(window, {
4	timeout: 1000,
5});
6
7let result;
8
9try {
10	result = interpreter.evaluate("1+1");
11	console.log(result);
12
13	interpreter.evaluate("var a=100");
14	interpreter.evaluate("var b=200");
15	result = interpreter.evaluate("a+b");
16
17	console.log(result);
18} catch (e) {
19	console.log(e);
20}

参数

1interface Options {
2	// 默认为：0，不限制
3	timeout?: number;
4	// 根作用域，只读
5	rootContext?: {} | null;
6	globalContextInFunction?: any;
7}

示例

import { Interpreter } from "eval5";

const ctx = {};
const interpreter = new Interpreter(ctx, {
    rootContext: window,
	timeout: 1000,
});

interpreter.evaluate(`
    a = 100;
    console.log(a); // 100
`);

window.a;//undefined

Interpreter

version

当前版本

global

默认值: {}

设置默认的全局作用域

1Interpreter.global = window;
2const interpreter = new Interpreter();
3interpreter.evaluate('alert("hello eval5")');

globalContextInFunction

默认值: undefined

eval5 不支持 use strict 严格模式, 在非严格下的函数中this默认指向的是全局作用域，但在eval5中是undefined， 可通过globalContextInFunction来设置默认指向。

1import { Interpreter } from "Interpreter";
2
3const ctx = {};
4const interpreter = new Interpreter(ctx);
5interpreter.evaluate(`
6this; // ctx
7function func(){
8    return this; // undefined
9}
10func();
11`);

1import { Interpreter } from "Interpreter";
2
3Interpreter.globalContextInFunction = window;
4const ctx = {};
5const interpreter = new Interpreter({});
6interpreter.evaluate(`
7this; // ctx
8function func(){
9    return this; // window
10}
11func();
12`);

原因，示例代码：

注意: alert异常

import { Interpreter } from "Interpreter";

Interpreter.globalContextInFunction = {};

const ctx = {alert: alert};

const interpreter = new Interpreter(ctx);

interpreter.evaluate(`
// throw Illegal invocation
alert('Hello eval5'); // 同 alert.call({}, 'Hello eval5')
`);

constructor(context = Interpreter.global, options?: Options )

构造函数

Interpreter 的实例方法

evaluate(code: string): any

执行给定的字符串代码，并返回最后一个表达式的值

1import { Interpreter } from "Interpreter";
2
3const interpreter = new Interpreter(window);
4
5const result = interpreter.evaluate(`
6var a = 100;
7var b = 200;
8
9a+b;
10
11`);
12
13console.log(result); // 300

appendCode(code: string): any

evaluate的别名

getExecutionTime(): number

获取上一次调用evaluate的执行时长

setExecTimeout(timeout: number = 0): void

设置执行时长

getOptions(): Readonly<Options>

获取解释器参数

---

evaluate(code: string, ctx?: {}, options?: Options)

执行给定的字符串代码，并返回最后一个表达式的值

注: 该函数每次执行都会创建一个新的解释器

1import { evaluate } from "eval5";
2
3evaluate(
4	`
5var a = 100;
6var b = 100;
7console.log(a+b);
8`,
9	{ console: console }
10); // 200
11
12evaluate(`
13    a;
14`); // a is not defined

Func

该函数会将Interpreter.global Interpreter.globalContextInFunction当作默认值并创建新的解释器

1import { Func } from "eval5";
2
3const func = new Func("a", "b", "return a+b;");
4console.log(func(100, 200)); // 300

vm

查看 vm

• vm.createContext
• vm.compileFunction
• vm.runInContext
• vm.runInNewContext
• vm.Script

License

MIT

相关

• evaljs
• closure-interpreter