Implementing a Cross‑Platform Lightweight JavaScript Engine: QuickJS, V8 TurboFan, and libuv Integration

The article begins with an overview of JavaScript as an ECMAScript implementation and introduces the concept of a cross‑platform lightweight JS engine, emphasizing efficiency, flexibility, and portability.

It then describes the JavaScript language, its history, and the role of JavaScript engines, listing common engines and focusing on V8’s TurboFan optimization pipeline, which analyzes function call patterns to generate specialized machine code.

Next, the QuickJS engine is introduced. QuickJS is a small, embeddable JavaScript engine supporting ES2023, including modules, async generators, proxies, and BigInt, with features such as fast startup, near‑complete ES2023 support, and a reference‑counted garbage collector.

The engine’s source layout is shown, highlighting key files (e.g., quickjs.c , libbf.c , quickjs-libc.c ) and their responsibilities.

QuickJS’s execution model is explained: a stack‑based interpreter that first generates unoptimized bytecode, then applies two optimization passes to produce more efficient bytecode, as illustrated with a simple sum(a, b) function.

Memory management in QuickJS relies on reference counting and temporary arrays to break cyclic references, ensuring deterministic cleanup.

Installation steps are provided (e.g., sudo make && sudo make install ) and the three command‑line tools— qjs (interpreter), qjsc (compiler), and qjscalc (REPL calculator)—are described.

To extend QuickJS, the article shows how to write a C extension module that exports a plus function, modify the Makefile, register the module, and compile it into an executable, demonstrating the output my_module.plus: 3 .

The integration with libuv is then covered. libuv is a multi‑platform asynchronous I/O library originally built for Node.js, offering event loops, TCP/UDP sockets, DNS, file system operations, and more.

The libuv run loop implementation ( uv_run ) is outlined, followed by a minimal example that creates a timer callback.

Finally, the article presents a complete example that combines QuickJS with libuv, implementing setTimeout in JavaScript using libuv timers, handling promises, and running an event loop that processes both JavaScript and libuv events.

Throughout, code snippets are preserved within ... tags to retain their original form.