node-js 0.1.13

JavaScript as a fusevm frontend: a lexer/parser and compiler to fusevm::Chunk on a JsHost object heap, with no bespoke VM or JIT
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

.TH NODE 1 "2026-07-19" "node-js 0.1.13" "User Commands"
.SH NAME
node \- JavaScript on fusevm, a compiled JS runtime (bytecode VM + Cranelift JIT)
.SH SYNOPSIS
.B node
[\fIOPTIONS\fR] [\fIFILE\fR] [\fIARGS\fR...]
.br
.B node
\fB\-e\fR \fISRC\fR [\fIARGS\fR...]
.SH DESCRIPTION
.B node-js
lexes and parses JavaScript and lowers it to
.B fusevm
bytecode executed on a Cranelift JIT over a JsHost object heap.
There is no bespoke VM or JIT; execution and codegen live in fusevm.
Object, string, and array cells ride through the VM as handles into that heap.
.PP
With no
.B \-e
and no
.I FILE
argument,
.B node
reads a script from standard input and runs it.
.SH OPTIONS
.TP
.B \-e \fISRC\fR, \-\-eval \fISRC\fR
Evaluate a one\-liner instead of a file.
.TP
.B \-p \fISRC\fR, \-\-print \fISRC\fR
Evaluate a one\-liner and print its completion value, as
.B node \-p
does. With both
.B \-e
and
.B \-p
present, the last one on the command line wins.
.TP
.B \-\-repl
Start the interactive REPL. This is also the default with no
.I FILE
argument on a terminal.
.TP
.B \-\-lsp
Speak the Language Server Protocol over stdio. Takes no
.IR FILE .
.TP
.B \-\-dap
Speak the Debug Adapter Protocol over stdio. Takes no
.IR FILE .
.TP
.B \-\-build
Ahead\-of\-time compile
.I FILE
to a standalone native executable instead of running it.
.TP
.B \-\-dump\-bytecode
Print the compiled fusevm bytecode for
.I FILE
and exit, instead of running it. Distinct from
.BR \-\-disasm ,
which prints a formatted disassembly listing.
.TP
.B \-\-no\-warnings
Silence all
.B process.emitWarning
output.
.TP
.B \-\-no\-deprecation
Silence DeprecationWarnings only.
.TP
.B \-\-trace\-warnings
Suppress the one\-time
.RB "(Use `" "node \-\-trace\-warnings ..." "`)"
hint. Unlike Node, this does not add a creation stack to the warning.
.TP
.B \-\-trace\-deprecation
The same, for DeprecationWarnings.
.TP
.B \-\-dump\-tokens
Print the lexer token stream for
.I FILE
(one \fIline\fR and token per line) and exit, instead of running it.
.TP
.B \-\-dump\-ast
Print the parsed AST for
.I FILE
and exit, instead of running it.
.TP
.B \-\-tiers
Run it, then report which fusevm execution tier took each of its chunks.
.TP
.B \-\-disasm
Print a fusevm bytecode disassembly listing for
.I FILE
(the main chunk, every user function's chunk, and every try block) and exit,
instead of running it.
.TP
.B \-h, \-\-help
Print help and exit.
.TP
.B \-V, \-\-version
Print version and exit.
.SH ARGUMENTS
.TP
.I FILE
The
.I .js
script to run. Omit it to read from standard input, or when
.B \-e
is given.
.TP
.I ARGS
Trailing arguments passed through to the JavaScript program.
.SH EXIT STATUS
Exits 0 on success. On error, a terse
.RB \(dq node:\ <reason> \(dq
message is written to standard error and the exit status is 1.
.SH EXAMPLES
Evaluate a one\-liner:
.PP
.RS
.EX
node \-e 'console.log(1 + 1)'
.EE
.RE
.PP
Run a script file:
.PP
.RS
.EX
node app.js
.EE
.RE
.PP
Pipe a script over standard input:
.PP
.RS
.EX
echo 'console.log("hi")' | node
.EE
.RE
.SH SEE ALSO
Project home: <https://github.com/MenkeTechnologies/node-js>