Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sstephenson/execjs
Run JavaScript code from Ruby
https://github.com/sstephenson/execjs
Last synced: about 2 months ago
JSON representation
Run JavaScript code from Ruby
- Host: GitHub
- URL: https://github.com/sstephenson/execjs
- Owner: sstephenson
- License: mit
- Archived: true
- Fork: true (rails/execjs)
- Created: 2011-02-06T20:23:29.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2016-02-13T19:07:21.000Z (over 8 years ago)
- Last Synced: 2024-05-08T18:34:13.380Z (5 months ago)
- Language: Ruby
- Homepage:
- Size: 1.79 MB
- Stars: 1,164
- Watchers: 39
- Forks: 46
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
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](https://github.com/cowboyd/therubyracer) - Google V8
embedded within Ruby
* [therubyrhino](https://github.com/cowboyd/therubyrhino) - Mozilla
Rhino embedded within JRuby
* [Node.js](http://nodejs.org/)
* Apple JavaScriptCore - Included with Mac OS X
* [Microsoft Windows Script Host](http://msdn.microsoft.com/en-us/library/9bbdkx3k.aspx) (JScript)
A short example:
``` ruby
require "execjs"
ExecJS.eval "'red yellow blue'.split(' ')"
# => ["red", "yellow", "blue"]
```
A longer example, demonstrating how to invoke the CoffeeScript compiler:
``` ruby
require "execjs"
require "open-uri"
source = open("http://coffeescript.org/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
```
# FAQ
**Why can't I use CommonJS `require()` inside ExecJS?**
ExecJS provides a lowest common denominator interface to any JavaScript runtime.
Use ExecJS when it doesn't matter which JavaScript interpreter your code runs
in. If you want to access the Node API, you should check another library like
[commonjs.rb](https://github.com/cowboyd/commonjs.rb) designed to provide a
consistent interface.
**Why can't I use `setTimeout`?**
For similar reasons as modules, not all runtimes guarantee a full JavaScript
event loop. So `setTimeout`, `setInterval` and other timers are not defined.
**Why can't I use ES5 features?**
Some runtimes like Node will implement many of the latest ES5 features. However
older stock runtimes like JSC on OSX and JScript on Windows may not. You should
only count on ES3 features being available. Prefer feature checking these APIs
rather than hard coding support for specific runtimes.
**Can ExecJS be used to sandbox scripts?**
No, ExecJS shouldn't be used for any security related sandboxing. Since runtimes
are automatically detected, each runtime has different sandboxing properties.
You shouldn't use `ExecJS.eval` on any inputs you wouldn't feel comfortable Ruby
`eval()`ing.
# License
Copyright (c) 2015 Sam Stephenson and Josh Peek.
Released under the MIT license. See `LICENSE` for details.