README.md
1# ARK JS Runtime Module<a name="EN-US_TOPIC_0000001183610495"></a>
2
3- [ARK JS Runtime Module<a name="EN-US_TOPIC_0000001183610495"></a>](#ark-js-runtime-module)
4 - [Introduction<a name="section190813718209"></a>](#introduction)
5 - [Directory Structure<a name="section161941989596"></a>](#directory-structure)
6 - [Constraints<a name="section119744591305"></a>](#constraints)
7 - [Build<a name="section137768191623"></a>](#build)
8 - [Available APIs<a name="section175841548124517"></a>](#available-apis)
9 - [Usage Guidelines<a name="section129654513264"></a>](#usage-guidelines)
10 - [Repositories Involved<a name="section1371113476307"></a>](#repositories-involved)
11
12### Introduction<a name="section190813718209"></a>
13
14ARK JS Runtime is the runtime used by JavaScript \(JS\) applications on OpenHarmony. It consists of the JS object allocator, garbage collector \(GC\), a standard library compliant with ECMAScript specifications, ARK bytecode interpreter, inline caches that store hidden classes, and the ARK Foreign Function Interface \(AFFI\).
15
16For more infomation, see: [ARK Runtime Subsystem](https://gitee.com/openharmony/docs/blob/master/en/readme/ARK-Runtime-Subsystem.md).
17
18**ARK JS runtime architecture**
19
20
21
22## Directory Structure<a name="section161941989596"></a>
23
24```
25/ark/js_runtime
26├─ ecmascript # JS object definition
27│ ├─ base # Base helper class
28│ ├─ builtins # ECMAScript library
29│ ├─ class_linker # Bytecode pre-processing module
30│ ├─ compiler # JS compiler
31│ ├─ hprof # Memory analysis utility class
32│ ├─ ic # Inline cache module
33│ ├─ interpreter # JS interpreter
34│ ├─ jobs # Queue of jobs
35│ ├─ js_vm # ARK command line tool
36│ ├─ mem # Memory management module
37│ ├─ napi # External native interface
38│ ├─ regexp # Regular expression engine module
39│ ├─ snapshot/mem # Snapshot module
40│ ├─ tests # Unit test cases
41│ ├─ thread # Thread pool
42│ ├─ tooling # JS debugger
43│ └─ vmstat # Runtime status utility classes
44└─ test # Module test cases
45```
46
47## Constraints<a name="section119744591305"></a>
48
49* Only the bytecode file generated by the ARK JS frontend can be run.
50* Only support ES2015 standard and strict mode ("use strict").
51* Don't support dynamically create functions via string (e.g., new Function("console.log(1))).
52
53## Build<a name="section137768191623"></a>
54
55```
56./build.sh --product-name Hi3516DV300 --build-target ark_js_runtime
57```
58
59### Available APIs<a name="section175841548124517"></a>
60
61For details, see [NAPI](https://gitee.com/openharmony/ace_napi/blob/master/README.md).
62
63### Usage Guidelines<a name="section129654513264"></a>
64
65For details about how to generate JS bytecodes, see [Using the Toolchain](docs/using-the-toolchain.md).
66
67To run bytecodes:
68```
69$ cd out/release
70$ export LD_LIBRARY_PATH=clang_x64/ark/ark_js_runtime:clang_x64/ark/ark:clang_x64/global/i18n:../../prebuilts/clang/ohos/linux-x86_64/llvm/lib/
71$ ./clang_x64/ark/ark_js_runtime/ark_js_vm helloworld.abc
72```
73
74For more infomation, please see: [ARK-Runtime-Usage-Guide](https://gitee.com/openharmony/ark_js_runtime/blob/master/docs/ARK-Runtime-Usage-Guide.md).
75
76## Repositories Involved<a name="section1371113476307"></a>
77
78[ark\_runtime\_core](https://gitee.com/openharmony/ark_runtime_core)
79
80**[ark\_js\_runtime](https://gitee.com/openharmony/ark_js_runtime)**
81
82[ark\_ts2abc](https://gitee.com/openharmony/ark_ts2abc)
83
