mirror of https://github.com/rails/execjs synced 2023-03-27 23:21:20 -04:00

Run JavaScript code from Ruby

Find a file

Matt Burke 28d8a056ef Fix gemspec.		2011-09-09 00:52:13 -04:00
lib	Define sh helper specific to ruby env	2011-09-07 15:35:45 -05:00
test	Merge branch 'master' into encoded-utf8	2011-08-03 11:31:39 -05:00
.gitignore	Add Gemfile	2011-06-07 16:05:18 -05:00
.travis.yml	Try 1.9.1 again	2011-06-07 21:58:46 -05:00
execjs.gemspec	Fix gemspec.	2011-09-09 00:52:13 -04:00
Gemfile	Add johnson to Gemfile	2011-06-18 13:34:25 -05:00
LICENSE	ExecJS 0.1.0	2011-03-10 17:38:33 -06:00
Rakefile	Formatting	2011-06-01 21:29:15 -05:00
README.md	Proper capitalization for SpiderMonkey	2011-06-18 13:32:26 -05:00

README.md

ExecJS

ExecJS lets you run JavaScript code from Ruby. It automatically picks the best runtime available to evaluate your JavaScript program, then returns the result to you as a Ruby object.

ExecJS supports these runtimes:

therubyracer - Google V8 embedded within Ruby
therubyrhino - Mozilla Rhino embedded within JRuby
Johnson - Mozilla SpiderMonkey embedded within Ruby
Mustang - Mustang V8 embedded within Ruby
Node.js
Apple JavaScriptCore - Included with Mac OS X
Mozilla SpiderMonkey
Microsoft Windows Script Host (JScript)

A short example:

require "execjs"
ExecJS.eval "'red yellow blue'.split(' ')"
# => ["red", "yellow", "blue"]

A longer example, demonstrating how to invoke the CoffeeScript compiler:

require "execjs"
require "open-uri"
source = open("http://jashkenas.github.com/coffee-script/extras/coffee-script.js").read

context = ExecJS.compile(source)
context.call("CoffeeScript.compile", "square = (x) -> x * x", :bare => true)
# => "var square;\nsquare = function(x) {\n  return x * x;\n};"

Installation

$ gem install execjs

License

Released under the MIT license. See LICENSE for details.