Skip to content
Ruby JavaScript
Find file
Pull request Compare This branch is 28 commits behind cowboyd:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib
spec
.gitignore
.gitmodules
Gemfile
README.md
Rakefile
commonjs.gemspec

README.md

CommonJS

Host CommonJS JavaScript environments in Ruby

Why?

The internet is now awash with non-browser JavaScript code. Much of this code conforms to some simple conventions that let you use it anywhere you have a JavaScript interpreter available. These conventions are collectively called "commonjs"

We have several JavaScript interpreters available to us from Ruby. Therefore, why shouldn't we be able to use commonjs applications and libraries?

Using common JS from Ruby.

CommonJS now passes all of the Modules 1.0 unit tests

env = CommonJS::Environment.new(:path => '/path/to/lib/dir')
env.require('foo.js')

Future directions

By default, all you get with a bare commonjs environment is the Modules API

The plan however, is to allow you to extend your commonjs environment to have whatever native interfaces you want in it. So for example, if you want to allow filesystem access, as well as access to the process information, you would say:

env.modules :filesystem, :process

Supported runtimes

Current

Desired

Something went wrong with that request. Please try again.