mirror of https://gitee.com/openharmony/arkcompiler_ets_runtime synced 2024-10-07 08:03:29 +00:00

Go to file

Gongyuhang 496687fe52 Desciption: Deal with the "use after free" error occurs while debugging ark_js_vm executable on windows. Details: Enclose the part where the LocalScope object should take effect with a pair of braces. Thus, the destructor of the LocalScope object will be called at the right brace which is above the JSNApi::DestroyJSVM() function. Issue: https://gitee.com/openharmony/ark_js_runtime/issues/I5C7XG Signed-off-by: Gongyuhang <gongyuhang5@huawei.com>		2022-06-14 16:13:59 +08:00
.gitee	refactor stl container	2022-04-06 16:05:22 +08:00
build	Update the third-party library path	2022-05-17 13:59:53 +08:00
docs	Documentation Modifications About Compilation	2022-04-18 14:12:24 +08:00
ecmascript	Desciption: Deal with the "use after free" error	2022-06-14 16:13:59 +08:00
script	Add Type Infer Test Case	2022-06-13 09:38:51 +08:00
test	!1529 Add Type Infer Test Case	2022-06-13 07:09:09 +00:00
.gitignore	Add TS Aot Test Framework	2022-04-25 21:28:10 +08:00
BUILD.gn	!1177 Require function realization	2022-06-09 12:51:21 +00:00
bundle.json	Pause compiling fuzzy use cases	2022-05-23 16:52:23 +08:00
js_runtime_config.gni	Descriptor: modify stream and add switch of enable_dump_in_faultlog	2022-05-21 16:37:04 +08:00
LICENSE	add ark js_runtime	2021-09-05 16:05:06 +08:00
OAT.xml	Added a filter in oat.xml	2022-04-15 16:21:39 +08:00
README_zh.md	JS Runtime official document modification	2022-06-09 15:13:44 +08:00
README.md	JS Runtime official document modification	2022-06-09 15:13:44 +08:00

README.md

ARK JS Runtime Module

ARK JS Runtime Module

Introduction

ARK 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.

For more information, see: ARK Runtime Subsystem.

ARK JS runtime architecture

Directory Structure

/ark/js_runtime
├─ ecmascript             # JS object definition
│   ├─ base               # Base helper class
│   ├─ builtins           # ECMAScript library
│   ├─ class_linker       # Bytecode pre-processing module
│   ├─ compiler           # JS compiler
│   ├─ containers         # Non-ECMAScript container library
│   ├─ cpu_profiler       # CPU Performance Analyzer
│   ├─ hprof              # Memory analysis utility class
│   ├─ ic                 # Inline cache module
│   ├─ interpreter        # JS interpreter
│   ├─ jobs               # Queue of jobs
│   ├─ js_vm              # ARK command line tool
│   ├─ mem                # Memory management module
│   ├─ napi               # External native interface
│   ├─ regexp             # Regular expression engine module
│   ├─ snapshot/mem       # Snapshot module
│   ├─ tests              # Unit test cases
│   ├─ thread             # Thread pool
│   ├─ tooling            # JS debugger
│   └─ vmstat             # Runtime status utility classes
└─ test                   # Module test cases

Constraints

Only the bytecode file generated by the ARK JS frontend can be run.
Only support ES2015 standard and strict mode ("use strict").
Don't support dynamically create functions via string (e.g., new Function("console.log(1))).

Build

./build.sh --product-name rk3568 --build-target ark_js_host_linux_tools_packages

Available APIs

For details, see NAPI.

Usage Guidelines

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

To run bytecodes:

LD_LIBRARY_PATH=out/rk3568/clang_x64/ark/ark:out/rk3568/clang_x64/ark/ark_js_runtime:out/rk3568/clang_x64/thirdparty/icu:prebuilts/clang/ohos/linux-x86_64/llvm/lib ./out/rk3568/clang_x64/ark/ark_js_runtime/ark_js_vm helloworld.abc

For more information, please see: ARK-Runtime-Usage-Guide.

Repositories Involved

ark_runtime_core

ark_js_runtime

ark_ts2abc