es2abc-benchmark

项目说明

本项目旨在对es2abc编译js时的性能进行测试并输出测试结果报告。
本项目依赖python3、git以及ets_frontend组件下的es2abc可执行文件。
其中测试用例默认存放在test_cases目录，运行结果存放在output目录。

用法说明

工具运行

参数说明

参数	描述	类型	默认值
--es2abc-tool	这个参数是必需的，需要提供一个es2abc工具的路径。	string	N/A
--runs	这个参数是可选的，默认值为20。表示一次测试中执行用例的次数。	int	20
--opt-level	这个参数是可选的，它指定了编译器的优化级别。	string	0
--parse-only	这个参数是可选的，默认值为False。如果设置为True，那么在测试期间，只会解析输入文件。	bool	False
--engine-comp	这个参数是可选的，默认值为False，此时，只进行es2abc测试，为True时与Hermes引擎对比	bool	False

测试用例说明

本项目测试套件及测试用例来源于开源库:

测试套件：

名称	描述	GitHub 地址
Octane	JavaScript基准测试套件，用于评估浏览器在处理复杂JavaScript任务时的性能	https://github.com/chromium/octane
Kraken	JavaScript性能测试套件，包含一系列的测试用例，涵盖了诸如动态场景、垃圾回收、加密和图形操作等方面	https://github.com/mozilla/krakenbenchmark.mozilla.org
SunSpider	JavaScript性能测试套件，用于评估JavaScript引擎在执行一些常见任务时的性能	https://github.com/mozilla/krakenbenchmark.mozilla.org

对比引擎

运行本benchmark时可进行es2abc编译性能与hermes编译性能对比,hermes引擎GitHub地址：https://github.com/facebook/hermes

运行示例

脚本运行时依赖ets_frontend组件编译后的es2abc可执行文件 es2abc编译命令：

$ ./build.sh --product-name rk3568 --build-target ets_frontend_build

指定es2abc可执行文件,运行run_benchmark.py进行测试:

$ python3 run_benchmark.py --es2abc-tool  /out/xx/xx/xx/ets_frontend/es2abc

与hermes引擎进行对比：

$ python3 run_benchmark.py --es2abc-tool  /out/xx/xx/xx/ets_frontend/es2abc --engine-comp

指定测试用例编译轮数(默认为20轮):

$ python3 run_benchmark.py --es2abc-tool  /out/xx/xx/xx/ets_frontend/es2abc --runs 10 

--parse-only 只对测试用例做解析动作，使用参数 --engine-comp时，本参数失效:

$ python3 run_benchmark.py --es2abc-tool  /out/xx/xx/xx/ets_frontend/es2abc --parse-only

--opt-level 指定编译优化等级，使用参数 --engine-comp时，本参数失效:

$ python3 run_benchmark.py --es2abc-tool  /out/xx/xx/xx/ets_frontend/es2abc --opt-level '2'

生成的测试结果存放至 output 目录，命令行打印基本的测试信息，如:

> > > benchmark running
Running navier-stokes....
Running typescript....
Running mandreel....

注意事项

本工具依赖ets_frontend组件编译产物es2abc可执行文件,使用时需指定es2abc路径。
本工具测试用例为开源用例,测试套件在运行时自动拉取。