Home

Usage

To run the Narcissus shell, install the SpiderMonkey shell and either set the NJS_SHELL environment variable to the path to the js executable, or creating a symbolic link to js in the top-level Narcissus directory. Then run Narcissus with the njs script.

Usage: njs

Options:
  -h, --help            show this help message and exit
  -f FILE, --file=FILE  JS file to load
  -e JS_EXPS, --expression=JS_EXPS
                        JS expression to evaluate
  -i, --interactive     enable interactive shell
  -H, --harmony         enable ECMAScript Harmony mode
  -S, --ssa             enable parse-time SSA construction

Running the test suite

Before a pull request is accepted, you must run the SpiderMonkey test suite through njs and make sure that no new tests are failing.

TODO: info on running test suite

Technical documentation

See the Narcissus internals for technical documentation.

Get involved

Here's how you can get involved with Narcissus:

• Join the mailing list (archives)
• Join the #narcissus channel on irc.mozilla.org
• Read up on Narcissus bugs in Bugzilla
• Submit new Narcissus bugs in Bugzilla
• Hack!

Open tasks

Looking for coding projects to contribute to? Here are some areas where we could use your help:

• Bug 584777 tracks open code-cleanup bugs.
• The tests/narcissus-failures.txt file tracks our current failing SpiderMonkey tests.
• Bug 595287: implement ES5 strict mode

Fork this code!

Narcissus is open source code. You can always fork the code and modify it. If you'd like to contribute your edits back to us, you can do a pull request on Github. However, we can only accept pull requests from people who have filled out a Mozilla committer's agreement. If you have any trouble with this process, feel free to ask us for help on #narcissus and we'll do everything we can to help.