A complete JavaScript engine and runtime environment
for Classic Amiga, MorphOs and AmigaOs4
Built from scratch in C, targeting MC68000 and AmigaOS 2.0+.
Inspired by Node.js, adapted for the Amiga platform.
Documentation: http://juen.in/NodeAmiga/
Support author: http://juen.in/support/
Features
--------
* JavaScript engine (ES5.1 + ES6+ features)
- Arrow functions, classes with inheritance, super(), static
- Class fields: public, private (#field), static
- Template literals, tagged
- Destructuring, spread/rest, default parameters
- for-of loops, labeled break/continue
- Regex literal /pattern/flags
- Optional chaining (?.), nullish coalescing (??)
- BigInt (123n, arithmetic, comparison, BigInt())
- let/const block scoping, numeric separators
- async/await, Promises, dynamic import()
- Generators (function*, yield, yield* delegation)
- Async generators (async function*, for await...of)
- Generator methods in classes and objects
- Automatic Semicolon Insertion (ASI)
- Closures, prototype chain
* Built-in objects and functions
- console (log, error, warn, dir, time/timeEnd, table,
count/countReset)
- Math (27 functions incl. cbrt/fround/clz32/imul)
- JSON (with reviver/replacer)
- Date (full API incl. UTC, getUTC*/setUTC*)
- RegExp (lookahead, non-capturing groups, quantifiers, lazy,
named groups, lookbehind, flags g/i/m/s/u/y)
- Buffer (hex/base64)
- Promise (then/catch/finally/all/race/allSettled)
- Map, Set, WeakMap, WeakSet, Symbol
- setTimeout/setInterval/clearTimeout
- crypto (MD5, SHA-256), structuredClone
- TextEncoder, TextDecoder
- Typed Arrays: Uint8Array, Int8Array, Uint16Array, Int16Array,
Uint32Array, Int32Array, Float32Array, Float64Array,
Uint8ClampedArray, ArrayBuffer, DataView
(from/of, forEach/map/filter/find/every/some/reduce,
set/fill/slice/subarray/reverse/indexOf/includes/join)
- fetch() global HTTP client
- performance.now() timer
- Error.cause (ES2022)
- process.stdout.write, process.stdin.read
- process.hrtime, process.nextTick, queueMicrotask
* String methods: 29+ (charAt, indexOf, slice, split, replace,
replaceAll, trim, includes, startsWith, padStart, normalize,
localeCompare, codePointAt, etc.)
* Array methods: 37+ (push, pop, map, filter, reduce, reduceRight,
sort, find, findLast, findLastIndex, forEach, every, some, splice,
flat, flatMap, entries, keys, values, copyWithin, at,
Array.from/of/isArray, toReversed, toSorted, toSpliced, with)
* Object: keys, values, entries, assign, create, freeze, seal, is,
fromEntries, defineProperty/ies, hasOwn, getPrototypeOf,
setPrototypeOf, getOwnPropertyNames,
getOwnPropertyDescriptor(s), preventExtensions, isExtensible,
groupBy, getOwnPropertySymbols, getters/setters
* Number: isInteger, isFinite, isNaN, isSafeInteger, parseInt,
parseFloat, toString(radix), toFixed, toExponential, toPrecision,
constants (EPSILON, MAX_SAFE_INTEGER, MIN_SAFE_INTEGER, NaN,
Infinity)
* Global functions: encodeURIComponent, decodeURIComponent,
encodeURI, decodeURI, parseInt, parseFloat, isNaN, isFinite,
eval(), fetch()
* Symbol: Symbol(), Symbol.for/keyFor, well-known symbols, Symbol
as property key, Iterator protocol (Symbol.iterator)
* Amiga Intuition GUI bindings
- Open windows with title, size, position
- Graphics: lines, rects, circles, text, pixels
- Mouse and keyboard events
- System requesters (alert, confirm)
- Screen information query
* GadTools GUI toolkit (gui module)
- createWindow() with declarative gadget layout
- 12 widget types: button, string, text, integer, checkbox,
cycle, slider, listview, mx, number, scroller, area
(bevel box)
- gui.gfx: drawing on GadTools windows (setColor, drawLine,
fillRect, drawCircle, drawText, setPixel, setFont, etc.)
- innerSize() for drawable area, auto GZZ offset
- Resizable windows (GIMMEZEROZERO clipping)
- Percentage layout (left: "50%", width: "80%")
- Negative positioning (top: -20 = anchor bottom)
- flex: true - gadget expands to fill available space
- minWidth/minHeight
- font: { name, size } per-window custom font (e.g.
topaz.font 8 for fixed-width column alignment)
- Event-driven: waitEvent/pollEvent, gadgetup/gadgetdown/
mousemove/close/key
- evt.x, evt.y mouse coords on gadget events
- get/set gadget values at runtime
- setTitle, listview dynamic item update
- Menu bar: setMenu() with keyboard shortcuts
- ASL file requester: fileRequest() with patterns
- ASL font requester: fontRequest()
- Proper GadTools cleanup
* Clipboard module (clipboard)
- read() - read text from system clipboard
- write(text) - write text
- clear() - clear clipboard
- Uses IFF FTXT/CHRS via iffparse.library
* ARexx module (arexx)
- send(port, command) - send ARexx command to app
- createPort(name) / closePort()
- getMsg() / waitMsg() / reply()
- listPorts() - list all public message ports
- Uses rexxsyslib.library
* FFI module (amiga)
- Direct Amiga library function calls from JavaScript
- openLibrary(name, version) / closeLibrary(lib)
- call(lib, offset, regs) - call any library function with
register args
- peek8/16/32(addr), poke8/16/32(addr, val) - memory access
- peekString(addr), pokeString(addr, str)
- allocMem(size, flags) / freeMem(ptr, size)
- makeTags(array) - build TagItem array for Amiga tag-based APIs
- Full 32-bit unsigned support (0xDEADBEEF etc.)
* Interactive debugger (--debug)
- Step, next, step-out, continue
- Breakpoints by line number
- Variable inspection (p varname)
- Call stack backtrace (bt)
- Source listing around current line
* Node.js-compatible modules
- require() with caching
- CommonJS exports (module.exports)
- ES modules: import/export (default, named, namespace)
- Dynamic import() expression
- Native modules: fs, http, net, buffer, os, child_process,
crypto, intuition, gui, readline, dns, clipboard, arexx,
amiga
- JS modules: path, events, url, querystring, util, stream,
assert, repl, timers, string_decoder, punycode, console,
constants, zlib, iff
* File I/O (fs module)
- readFileSync, writeFileSync, appendFileSync
- existsSync, unlinkSync, renameSync, statSync
- readdirSync, mkdirSync, rmdirSync, copyFileSync
- readFile, writeFile (async)
- createReadStream, createWriteStream
- Full AmigaOS path support (Volume:dir/file)
* HTTP/HTTPS server and client
- http.createServer() non-blocking, 8 concurrent
- http.get(), http.post(), http.request()
- HTTPS via AmiSSL (build with -DENABLE_AMISSL)
- Auto redirect following (301/302/307)
- 10-second socket timeout, dns.lookup()
- Requires bsdsocket.library (Roadshow, Miami, AmiTCP)
* OS integration
- process.platform ("amigaos"), process.arch ("m68k")
- process.argv, process.env, process.cwd(), process.exit
- os.cpus() (detects 68000/020/030/040/060)
- os.freemem(), os.version() (Kickstart version)
- child_process.execSync() via SystemTagList()
* Interactive REPL with command history (arrow up/down)
* Error types: Error, TypeError, RangeError, ReferenceError,
SyntaxError, EvalError, URIError
* Error messages with filename and line number
* Compiler: bundle JS + interpreter into standalone executable
- NodeAmiga -compile MyApp script.js
- Automatic require() and import dependency resolution
- All JS modules bundled into single executable
- No NodeAmiga, no libs/ needed to run the output
Usage
-----
NodeAmiga script.js
Execute a JavaScript file
NodeAmiga -e "code"
Evaluate inline JavaScript
NodeAmiga -compile out script
Compile to standalone exe
NodeAmiga
Start interactive REPL
NodeAmiga -help
Show help
NodeAmiga -v
Show version
NodeAmiga --vm script.js
Use bytecode VM (experimental)
NodeAmiga --tree script.js
Use tree-walking interpreter (default)
NodeAmiga --debug script.js
Run with interactive debugger
NodeAmiga --ast script.js
Print AST (debug)
Installation
------------
1. Copy NodeAmiga to C: or any directory in your path
2. Copy the libs/ directory to PROGDIR: (same directory as
NodeAmiga), or to LIBS:node/
3. Optional: copy examples/ for demo scripts
Quick test:
NodeAmiga -e "console.log('Hello Amiga!')"
NodeAmiga examples/hello.js
NodeAmiga examples/gui_hello.js
NodeAmiga examples/fibonacci.js
Compile to standalone exe:
NodeAmiga -compile Hello examples/hello.js
Hello
; Runs without NodeAmiga or libs/ !
System Requirements
-------------------
* MC68000 or higher CPU
* AmigaOS 2.04 (Kickstart 37) or higher
* Minimum 1 MB RAM (2+ MB recommended)
* bsdsocket.library for networking features (Roadshow, Miami,
AmiTCP)
* No FPU required (software floating-point)
Technical Details
-----------------
* Engine: custom-built lexer, recursive descent parser with Pratt
precedence climbing, tree-walking interpreter (default).
A bytecode VM is also bundled (--vm) but currently experimental
and disabled by default while issues are sorted out.
* Memory: reference counting (no GC pauses), arena allocator for
AST, integer cache 0-255
* Stack: auto-allocates 64 KB via StackSwap
Included Examples
-----------------
hello.js
Platform info and greeting
fibonacci.js
Recursive/iterative benchmark
file_io.js
File read/write/append
http_server.js
HTTP server with routing
http_client.js
HTTP GET and POST requests
classes.js
ES6 classes with inheritance
closures.js
Closures, IIFE, module pat.
array_fun.js
map/filter/reduce/sort
regex.js
RegExp /literal/ and methods
events.js
EventEmitter custom events
promises.js
Promise chains, all, race
timers.js
setTimeout and setInterval
buffer.js
Binary data manipulation
streams.js
Readable/Writable/Transform
sysinfo.js
Full system info display
todo_app.js
TODO app with persistence
mini_grep.js
Pattern search in files
url_parser.js
URL and query string parsing
calculator.js
Recursive descent expr parser
json_db.js
JSON file-based database
myip.js
Fetch public IP from internet
nettime.js
Internet time via HTTP API
weather.js
Weather info for a city
download.js
Download file and save
gui_hello.js
Simplest Intuition window
gui_demo.js
Interactive drawing + mouse
gui_calculator.js
GadTools calculator (320x200)
3d.js
Rotating 3D wireframe cube
3d_tunnel.js
Wireframe tunnel fly-through
pong.js
Bouncing ball (XOR, circle)
gui_translator.js
Google Translate with GUI
gui_window.js
GadTools widget gallery
gui_menu.js
Menu bar + ASL requesters
gui_drawing.js
gui.gfx primitives (4 scenes)
gui_gfx_clock.js
Analog clock (resizable)
gui_keyboard_and_scrolls.js
Arrow keys + scrollers demo
gui_weather.js
Weather app with GadTools GUI
aminet_browser.js
Aminet archive browser + GUI
aminet_browser_opt.js
Optimized variant of aminet_browser
gui_disasm.js
68k disassembler for Amiga EXE
gui_monitor.js
System monitor (mem/tasks/libs)
gui_ftp_client.js
FTP client (PASV) with GUI
gui_extra_demo.js
Modal dialogs + image + colour
gui_rss.js
RSS / Atom feed reader (GUI)
clipboard.js
System clipboard read/write
arexx.js
ARexx port communication
dns_lookup.js
DNS hostname resolution
readline_chat.js
Interactive readline + prompt
readline_file.js
readline over a file stream
ffi.js
Amiga library FFI demo
locale_demo.js
locale.library catalogs + ENV
iff_info.js
IFF/ILBM/8SVX file viewer
Known Limitations
-----------------
* No Proxy
* await is synchronous (spin-waits on event loop)
Version History
---------------
0.26.0 (2026-05-13)
Spec gaps + perf + diagnostics: property
descriptors complete, Error.stack with
file:line:col, fetch headers/arrayBuffer,
cycle-breaking GC, Map/Set hash backing
(O(1) lookup), named regex captures, tagged
template raw, typed-array merge sort,
unhandledRejection / heapSnapshot, locale
module, all four CPU variants.
0.25.0 (2026-05-07)
Spec correctness + memory hardening driven by
a new 2300-assertion test suite. Fixes
NaN/parseInt edge cases, JSON.stringify
output, descriptor flags, Object.prototype
chain, non-enumerable proto methods, arrow
`this`, let-per-iteration, RegExp limits,
fetch text/json methods and an ~19 MB-per-
run cleanup leak.
0.24.0 (2026-05-05)
Readline file streaming, template literal
expression parts, RegExp.flags, sparse array
length, SameValueZero NaN, toFixed half-up,
caught by the new 1000-test extra suite.
0.23.0 (2026-05-04)
Fixes a per-statement refcount leak that
pinned every `var x = literal` and every
object-property value, gradually exhausting
the JsProperty pool. Adds runtime cycle/mx
gadget items, process.poolStats() and
alloc-failure stderr surfaces.
0.22.0 (2026-04-30)
Raw TCP via net.connect, FTP client example,
GUI modal requesters (alert/confirm/prompt/
colorRequest), datatypes-backed image
loading, chunked HTTP decode, full Unicode
fromCharCode/fromCodePoint, stable merge
sort for Array.prototype.sort.
0.21.0 (2026-04-23)
Lexer/await/iff/web-runtime fixes, tree-
walking interpreter promoted to default,
compiled executables embedded as HUNK_DATA
(no more "object in use" Locks), online
user docs at juen.in/NodeAmiga/.
0.20.0 (2026-04-17)
Equality fixes on tagged ints (0 === "0"
was true), Promise.finally pass-through,
String/Number .toString()/.valueOf(), and
custom per-window fonts in gui.createWindow.
0.19.0 (2026-04-16)
New FFI module require('amiga') for calling
any Amiga library function from JavaScript
(openLibrary, call with register args,
peek/poke, allocMem, makeTags). Adds the
Area gadget and debugger 'p' for recursive
pretty-print.
0.18.1 (2026-04-14)
Scroller drag ID, non-GZZ gadget coords, and
MOUSEMOVE gadget identification fixes.
0.18.0 (2026-04-13)
Arrow keys / F1-F10 / Help via IDCMP_RAWKEY
(evt.key as named string) plus vertical
scrollers and structured gui.set scroller
updates.
0.17.0 (2026-04-12)
New gui.gfx drawing sub-module (lines,
rectangles, circles, ellipses, pixel
primitives, text and font) on GadTools
windows, with EraseRect-based GZZ-safe
clear and proper inner-size sizing.
Credits
-------
Juen/R3D+Appendix+Nah-Kolor
|
aminet net>