bellard/mquickjs
Mquickjs
mQuickjs is a compact JavaScript engine designed for memory-constrained devices, such as microcontrollers, requiring as little as 10 KB of RAM and 100 KB of ROM. It achieves this through a fixed-buffer memory allocation scheme that avoids system heap usage, a compacting tracing garbage collector that eliminates fragmentation, and a ROM-embedded standard library that reduces both memory footprint and startup time. The engine compiles JavaScript source into portable bytecode that can be stored in persistent memory and executed without reparsing, and it emulates IEEE 754 floating-point arithmetic in software on CPUs lacking hardware FPU support.
The engine provides a native C API for defining custom classes with constructors, finalizers, and property accessors, as well as exposing native functions as script closures. It supports precompiled bytecode stored in read‑only memory for instant execution, and it enforces a safer language subset by forbidding constructs like uninitialized arrays and dynamic evaluation. These features make it suitable for lightweight scripting in firmware projects where deterministic behavior, minimal memory overhead, and native extension integration are required.
Features
- Code Execution Runtimes - Executes JavaScript code from source or compiled bytecode in embedded environments.
- Lightweight Scripting Engines - Adds a lightweight JavaScript scripting layer to microcontroller firmware.
- Fixed-Buffer Runtime Contexts - Creates JavaScript runtime contexts from a single preallocated fixed memory buffer, avoiding system heap allocation for deterministic behavior.
- Source-to-Bytecode Compilers - Compiles JavaScript source into portable bytecode for persistent storage and execution without recompilation.
- JavaScript Engine Embedding - Embeds a JavaScript runtime as a component within a host application, requiring as little as 10 KB of RAM and 100 KB of ROM.
- Native Class Mappings - Maps native C data structures to JavaScript classes with constructors, finalizers, and property accessors for embedded scripting.
- Compacting Garbage Collectors - Implements a compacting garbage collector that moves live objects to eliminate memory fragmentation in constrained environments.
- Precompilation - Compiles JavaScript source into portable bytecode for storage and execution without reparsing.
- C Function Bindings - Provides a C API to define native classes and functions callable from JavaScript.
- Native Bindings - Provides a native C API for defining custom JavaScript classes with constructors, finalizers, and property accessors.
- Native-to-Script Function Invocations - Enables calling JavaScript functions from native C code, passing arguments and receiving return values in an embedded environment.
- ROM-Embedded Standard Libraries - Embeds the JavaScript standard library as precompiled C data structures for fast startup and low memory.
- Runtime Bytecode Compilation - Compiles JavaScript source into portable bytecode that can be stored in persistent memory and executed without runtime compilation overhead.
- Floating Point Emulators - Emulates IEEE 754 floating-point arithmetic in software for CPUs without FPU.
- Native Function Closures - Exposes native C functions as JavaScript closures with captured parameters, callable from script code in embedded environments.
- Fixed Memory Buffers - Uses a fixed preallocated memory buffer to eliminate system heap usage for deterministic behavior.
- Native C Extension APIs - Provides a C API to define native classes and functions callable from JavaScript in constrained environments.
- Language Subset Enforcement - Enforces a safer JavaScript subset by prohibiting uninitialized arrays and dynamic evaluation.
- Floating-Point Packers - Converts between floating-point and integer representations with configurable rounding and overflow handling.
- Scripting and Bindings - Micro-sized JavaScript engine targeted at embedded system environments.
