Skip to content


Subversion checkout URL

You can clone with
Download ZIP
JSX - a faster, safer, easier JavaScript
JavaScript Perl Perl6 HTML CSS Makefile Other
Branch: master

Merge pull request #337 from ojwb/patch-1

Fix typo: "generatedy" -> "generated"
latest commit a554cd42ea
@kazuho kazuho authored
Failed to load latest commit information.
bin dead-copy bin/jsx-profile-server to src/profile-server.jsx
complete add small doc for jsx --completion
doc [doc update] profiler is now "jsx-profile-server"
etc mv src/doc etc/doc-template
example fix name
extlib add Text::MicroTemplate to extlib
idl2jsx update web.jsx
lib use Function() to obtain global ref (for better compatibility with st…
src Fix typo: "generatedy" -> "generated"
submodules port profile-server to JSX
t cherry-pick the test case from PR #329
tmp keep tmp/
tool update bootstrap-compiler.js
web web/ no longer loads the compilation server (was it actually …
xt/optimize-bench add a benchmark test script
.gitattributes add .gitattributes to use [diff "jsx"] section in gitconfig
.gitignore doc/ must not be ignored
.gitmodules port profile-server to JSX
.npmignore strip-down the files packed as npm
.proverc remove --trap flag from .prove
.travis.yml allow travis failure on node.js 0.8, the environment fails to install… add
Changes releng for 0.9.89 add "Bootstrap" section to
LICENSE add "et al." to the copyright clause of each file, clarify in LICENSE…
Makefile port profile-server to JSX Fix typo in
gruntfile.js do not watch src/meta.jsx on `grunt watch`
package.json update dependencies close #144; the author must do `make publish` instead of `npm publish`

NAME Build Status

JSX - a faster, safer, easier JavaScript


The JSX compiler toolkit is released as a npm package, so you can install it with npm install -g jsx.


There's jsx(1) command to compile JSX source code into JavaScript.

Type the following commands and see what happens:

# run Hello World in JSX
jsx --run example/hello.jsx

# compile it and output the generated code to stdout
jsx example/hello.jsx

# compile it with full optimizations
jsx --release --output hello.jsx.js example/hello.jsx

# compile it for node and execute it
jsx --executable node --output hello.jsx.js example/hello.jsx
./hello.jsx.js # displays "Hello, world!"

# run a test, calling _Test#test*()
jsx --test example/import.jsx # import.jsx has _Test

jsx --help shows how to to use the jsx command.


Here is a fizzbuzz problem, which can be executed by jsx --run fizzbuzz.jsx, showing a basic syntax of JSX.

class _Main {
    static function main(args :string[]) : void {
        for (var i = 1; i <= 100; ++i) {
            if (i % 15 == 0)
                log "FizzBuzz";
            else if (i % 3 == 0)
                log "Fizz";
            else if (i % 5 == 0)
                log "Buzz";
                log i;

See the documentation for details.


There are JSX source files in example/ and web/example/, and the the test directory t/.


If you are interested in development of the JSX compiler, you should set up your environment after cloning the repo. The SDK development requires LSB 4.1 (Perl 5.8.8 and some UNIX commands) as well as NodeJS 0.8.0 or later.

To setup JSX SDK, type the following command:

git clone --recursive git://
cd JSX
make # to build bin/jsx
# edit JSX compiler source files
make test # to make sure it works

We recommend to install jsx(1) as a link of $JSX/bin/jsx to ~/bin/jsx.

ln -s "$PWD/bin/jsx" ~/bin


There's a web interface, which provides a web compiler and web application examples. Type the following commands to run the server:

make server # to run an HTTP daemon
open http://localhost:2012/

This server is also used to show results of JSX profiler. See Using the Profiler for details.


There are unit tests in t/ directory. Just type the following command to run the tests:

make test

These test cases are executed by prove(1) and dispatched by t/util/test-runner, and also requires phantomjs(1)

Note that if you make a pull request you have to make sure make test-all for complete tests.

NOTE: There are some TODO tests, which should be resolved in a future. make show-todo shows such TODOs.


npm install -g jsx should work even on Windows.


Something went wrong with that request. Please try again.