mirror of https://gitee.com/openharmony/arkcompiler_ets_runtime synced 2024-10-06 15:43:44 +00:00

Go to file

openharmony_ci 62caefba91 !9586 Bugfix: heap pointer may be invalid after gc Merge pull request !9586 from lukai/stringtablebugfix		2024-10-06 14:39:53 +00:00
.gitee	Reason:add checklist	2024-06-29 16:45:08 +08:00
compiler_service	Modify idle compile strategy as aot compiler crash	2024-09-14 18:31:35 +08:00
docs	Add AOT doc description	2024-09-27 16:41:05 +08:00
ecmascript	!9586 Bugfix: heap pointer may be invalid after gc	2024-10-06 14:39:53 +00:00
etc	[JIT] Add dumpobj for sync code	2024-09-14 09:15:28 +08:00
script	Fix warnings in gen_expect_output.sh	2024-08-12 18:21:09 +08:00
test	!9587 Add UT for GC	2024-10-06 10:27:40 +00:00
tools	!8479 Fix ASSERTION FAILED: newHclass->IsPrototype()	2024-08-09 02:50:52 +00:00
.gitignore	Add TS Aot Test Framework	2022-04-25 21:28:10 +08:00
BUILD.gn	!9576 Delete unused gc code	2024-10-06 12:51:21 +00:00
bundle.json	!9297 Modify idle compile strategy	2024-09-16 01:38:47 +00:00
CODEOWNERS	Display codeowners for hidden folders and files	2024-08-16 12:18:28 +03:00
hisysevent.yaml	add jit event	2024-05-14 14:38:56 +08:00
js_runtime_config.gni	[新需求]: Enable run_with_asan	2024-09-20 14:51:35 +08:00
libark_jsruntime.map	revert ffrt-based taskpool	2024-09-14 09:21:24 +08:00
LICENSE	add ark js_runtime	2021-09-05 16:05:06 +08:00
OAT.xml	add ap parse code	2024-07-30 15:10:04 +08:00
README_zh.md	Update Dead-link in docs	2023-11-01 11:24:56 +08:00
README.md	Modify ets_runtime readme.md	2023-05-09 15:05:35 +08:00
REVIEWERS	Update list of the reviewrs	2024-07-16 16:23:14 +03:00

README.md

ArkCompiler JS Runtime

Introduction

ArkCompiler JS Runtime is the default JS runtime on OpenHarmony. It supports ECMAScript libraries and efficient container libraries. It also provides a set of native APIs for C++ and JS interaction and a variety of garbage collectors that features high performance.

For more information, see ArkCompiler JS Runtime.

ArkCompiler JS Runtime architecture

Directory Structure

/arkcompiler/ets_runtime
├─ ecmascript             # Implementation of ArkCompiler JS Runtime, including the ECMAScript library, interpreter, and memory management
│   ├─ base               # Base helper class
│   ├─ builtins           # ECMAScript libraries
│   ├─ compiler           # JS compiler
│   ├─ containers         # Non-ECMAScript containers
│   ├─ dfx                # Memory and profiling tool
│   ├─ ic                 # Inline cache module
│   ├─ interpreter        # JS interpreter
│   ├─ jobs               # Queue of jobs
│   ├─ js_vm              # Command line tool
│   ├─ jspandafile        # abc file management module
│   ├─ mem                # Memory management module
│   ├─ module             # ECMAScript module
│   ├─ napi               # C++ API module
│   ├─ taskpool           # Task pool
│   ├─ regexp             # Regular expression engine module
│   ├─ snapshot           # Snapshot module
│   ├─ stubs              # Runtime stub functions
│   ├─ tests              # Unit test cases
│   ├─ debugger           # JS debugger
│   ├─ trampoline         # Trampoline function
│   ├─ ts_type            # TS type management module
└─ test                   # Module test cases

Constraints

Only the ArkCompiler bytecode files generated by ts2abc, which is the ArkCompiler JS frontend toolchain, can be run.
Only the ES2021 standard and strict modes are supported.
Functions cannot be dynamically created using strings, such as new Function("console.log(1);")).

Building

$./build.sh --product-name hispark_taurus_standard --build-target ark_js_host_linux_tools_packages

Available APIs

See NAPI.

Usage

For details about how to generate JS bytecodes, see Using the Toolchain.

To run bytecodes:

LD_LIBRARY_PATH=out/hispark_taurus/clang_x64/arkcompiler/ets_runtime:out/hispark_taurus/clang_x64/thirdparty/icu:prebuilts/clang/ohos/linux-x86_64/llvm/lib ./out/hispark_taurus/clang_x64/arkcompiler/ets_runtime/ark_js_vm helloworld.abc

For more information, see [ARK Runtime Usage Guide](https://gitee.com/openharmony/arkcompiler_ets_runtime/blob/master/ docs/ARK-Runtime-Usage-Guide.md).

Repositories Involved

arkcompiler_runtime_core

arkcompiler_ets_runtime

arkcompiler_ets_frontend