execjs 2.8.1 → 2.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bd129488d607b71ba6aec4c087036583727f4114d632107be2297b96a6a20f2
-  data.tar.gz: fea27c5987305700a3c5adbbe8f2e282dc5d49e6c579d2c91369886739342c26
+  metadata.gz: ca8fbffb11f9291f96946f05b1ea83be53c5882779a5b9d273bffd0cdfc81d2d
+  data.tar.gz: 9b3f12cf4b5662ea6c596323e932ff65c30350a982861b4818c2c36c989fa55d
 SHA512:
-  metadata.gz: 99fe4da9a1203aa378e4f73879db38d7f9737dedc92141c820e099229eac5d00e311ab56379d5a92ef41fa1323cedf2614ee2e971e0e5602096f30732aed1808
-  data.tar.gz: df6fb1647179df49bef56c5570fbc7148bfa1e290945e398482e369572764b60c1293c2220c6e3101d6bd9880d47d4084f2b1325c5f39d321a186ef4ec2ac639
+  metadata.gz: 6512ebadf69bce38417f1d6ab482c0724cad647a98a286d0ef76bdf07bad89bf76f5b1aa6b6db602f51b80304aeb4052a7bda15dd8b795206a38dbb32e590582
+  data.tar.gz: 41e1b872791ba893c8ab5786e3e105af4ff7b639c703e07f3e5b6f5822298e5a56c6b16c584586ec97b94ec9fad9b8dfa3f204c312807d12a0ecd020a3ea33dd

data/README.md

@@ -11,11 +11,13 @@ ExecJS supports these runtimes:
   Rhino embedded within JRuby
 * [Duktape.rb](https://github.com/judofyr/duktape.rb) - Duktape JavaScript interpreter
 * [Node.js](http://nodejs.org/)
+* [Bun.sh](https://bun.sh) - JavaScript runtime & toolkit designed for speed
 * Apple JavaScriptCore - Included with Mac OS X
 * [Microsoft Windows Script Host](http://msdn.microsoft.com/en-us/library/9bbdkx3k.aspx) (JScript)
 * [Google V8](http://code.google.com/p/v8/)
-* [mini_racer](https://github.com/discourse/mini_racer) - Google V8
+* [mini_racer](https://github.com/rubyjs/mini_racer) - Google V8
   embedded within Ruby
+* [GraalVM JavaScript](https://www.graalvm.org/javascript/) - used on TruffleRuby
 
 A short example:
 
@@ -29,14 +31,30 @@ 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
+require "net/http"
+source = Net::HTTP.get(URI("https://coffeescript.org/browser-compiler-legacy/coffeescript.js"))
 
 context = ExecJS.compile(source)
 context.call("CoffeeScript.compile", "square = (x) -> x * x", bare: true)
 # => "var square;\nsquare = function(x) {\n  return x * x;\n};"
 ```
 
+# Forcing a specific runtime
+
+If you'd like to use a specific runtime rather than the autodetected one, you can assign `ExecJS.runtime`:
+
+```ruby
+ExecJS.runtime = ExecJS::Runtimes::Node
+```
+
+Alternatively, you can define it via the `EXECJS_RUNTIME` environment variable:
+
+```bash
+EXECJS_RUNTIME=Node ruby ...
+```
+
+You can find the list of possible runtimes in [`lib/execjs/runtimes.rb`](https://github.com/rails/execjs/blob/master/lib/execjs/runtimes.rb).
+
 # Installation
 
 ```
@@ -47,7 +65,7 @@ $ gem install execjs
 
 **Why can't I use CommonJS `require()` inside ExecJS?**
 
-ExecJS provides a lowest common denominator interface to any JavaScript runtime.
+ExecJS provides the 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
@@ -74,7 +92,7 @@ You shouldn't use `ExecJS.eval` on any inputs you wouldn't feel comfortable Ruby
 
 ## Contributing to ExecJS
 
-ExecJS is work of dozens of contributors. You're encouraged to submit pull requests, propose
+ExecJS is the work of dozens of contributors. You're encouraged to submit pull requests, propose
 features and discuss issues.
 
 See [CONTRIBUTING](CONTRIBUTING.md).

data/lib/execjs/duktape_runtime.rb

@@ -6,21 +6,21 @@ module ExecJS
     class Context < Runtime::Context
       def initialize(runtime, source = "", options = {})
         @ctx = Duktape::Context.new(complex_object: nil)
-        @ctx.exec_string(encode(source), '(execjs)')
+        @ctx.exec_string(source.encode(Encoding::UTF_8), '(execjs)')
       rescue Exception => e
         raise wrap_error(e)
       end
 
       def exec(source, options = {})
         return unless /\S/ =~ source
-        @ctx.eval_string("(function(){#{encode(source)}})()", '(execjs)')
+        @ctx.eval_string("(function(){#{source.encode(Encoding::UTF_8)}})()", '(execjs)')
       rescue Exception => e
         raise wrap_error(e)
       end
 
       def eval(source, options = {})
         return unless /\S/ =~ source
-        @ctx.eval_string("(#{encode(source)})", '(execjs)')
+        @ctx.eval_string("(#{source.encode(Encoding::UTF_8)})", '(execjs)')
       rescue Exception => e
         raise wrap_error(e)
       end

data/lib/execjs/external_runtime.rb

@@ -1,11 +1,12 @@
-require "tmpdir"
 require "execjs/runtime"
+require "tmpdir"
+require "json"
 
 module ExecJS
   class ExternalRuntime < Runtime
     class Context < Runtime::Context
       def initialize(runtime, source = "", options = {})
-        source = encode(source)
+        source = source.encode(Encoding::UTF_8)
 
         @runtime = runtime
         @source  = source
@@ -15,7 +16,7 @@ module ExecJS
       end
 
       def eval(source, options = {})
-        source = encode(source)
+        source = source.encode(Encoding::UTF_8)
 
         if /\S/ =~ source
           exec("return eval(#{::JSON.generate("(#{source})", quirks_mode: true)})")
@@ -23,7 +24,7 @@ module ExecJS
       end
 
       def exec(source, options = {})
-        source = encode(source)
+        source = source.encode(Encoding::UTF_8)
         source = "#{@source}\n#{source}" if @source != ""
         source = @runtime.compile_source(source)
 
@@ -77,7 +78,7 @@ module ExecJS
                   .sub(filename, "(execjs)")
                   .strip
             end
-            stack.reject! { |line| ["eval code", "eval@[native code]"].include?(line) }
+            stack.reject! { |line| ["eval code", "eval code@", "eval@[native code]"].include?(line) }
             stack.shift unless stack[0].to_s.include?("(execjs)")
             error_class = value =~ /SyntaxError:/ ? RuntimeError : ProgramError
             error = error_class.new(value)
@@ -102,7 +103,13 @@ module ExecJS
       @popen_options[:internal_encoding] = ::Encoding.default_internal || 'UTF-8'
 
       if @runner_path
-        instance_eval generate_compile_method(@runner_path)
+        instance_eval <<~RUBY, __FILE__, __LINE__
+          def compile_source(source)
+            <<-RUNNER
+            #{IO.read(@runner_path)}
+            RUNNER
+          end
+        RUBY
       end
     end
 
@@ -142,15 +149,6 @@ module ExecJS
       end
 
     protected
-      def generate_compile_method(path)
-        <<-RUBY
-        def compile_source(source)
-          <<-RUNNER
-          #{IO.read(path)}
-          RUNNER
-        end
-        RUBY
-      end
 
       def json2_source
         @json2_source ||= IO.read(ExecJS.root + "/support/json2.js")
@@ -196,7 +194,7 @@ module ExecJS
         require 'shellwords'
 
         def exec_runtime(filename)
-          command = "#{Shellwords.join(binary.split(' ') << filename)} 2>&1"
+          command = "#{Shellwords.join(binary.split(' ') << filename)}"
           io = IO.popen(command, **@popen_options)
           output = io.read
           io.close
@@ -209,7 +207,7 @@ module ExecJS
         end
       else
         def exec_runtime(filename)
-          io = IO.popen(binary.split(' ') << filename, **(@popen_options.merge({err: [:child, :out]})))
+          io = IO.popen(binary.split(' ') << filename, **@popen_options)
           output = io.read
           io.close
 

data/lib/execjs/graaljs_runtime.rb

@@ -0,0 +1,146 @@
+require "execjs/runtime"
+
+module ExecJS
+  class GraalJSRuntime < Runtime
+    class Context < Runtime::Context
+      def initialize(runtime, source = "", options = {})
+        @context = Polyglot::InnerContext.new
+        @context.eval('js', 'delete this.console')
+        @js_object = @context.eval('js', 'Object')
+
+        source = source.encode(Encoding::UTF_8)
+        unless source.empty?
+          translate do
+            eval_in_context(source)
+          end
+        end
+      end
+
+      def exec(source, options = {})
+        source = source.encode(Encoding::UTF_8)
+        source = "(function(){#{source}})()" if /\S/.match?(source)
+
+        translate do
+          eval_in_context(source)
+        end
+      end
+
+      def eval(source, options = {})
+        source = source.encode(Encoding::UTF_8)
+        source = "(#{source})" if /\S/.match?(source)
+
+        translate do
+          eval_in_context(source)
+        end
+      end
+
+      def call(source, *args)
+        source = source.encode(Encoding::UTF_8)
+        source = "(#{source})" if /\S/.match?(source)
+
+        translate do
+          function = eval_in_context(source)
+          function.call(*convert_ruby_to_js(args))
+        end
+      end
+
+      private
+
+      ForeignException = defined?(Polyglot::ForeignException) ? Polyglot::ForeignException : ::RuntimeError
+
+      def translate
+        convert_js_to_ruby yield
+      rescue ForeignException => e
+        if e.message && e.message.start_with?('SyntaxError:')
+          error_class = ExecJS::RuntimeError
+        else
+          error_class = ExecJS::ProgramError
+        end
+
+        backtrace = (e.backtrace || []).map { |line| line.sub('(eval)', '(execjs)') }
+        raise error_class, e.message, backtrace
+      end
+
+      def convert_js_to_ruby(value)
+        case value
+        when true, false, Integer, Float
+          value
+        else
+          if value.nil?
+            nil
+          elsif value.respond_to?(:call)
+            nil
+          elsif value.respond_to?(:to_str)
+            value.to_str
+          elsif value.respond_to?(:to_ary)
+            value.to_ary.map do |e|
+              if e.respond_to?(:call)
+                nil
+              else
+                convert_js_to_ruby(e)
+              end
+            end
+          else
+            object = value
+            h = {}
+            object.instance_variables.each do |member|
+              v = object[member]
+              unless v.respond_to?(:call)
+                h[member.to_s] = convert_js_to_ruby(v)
+              end
+            end
+            h
+          end
+        end
+      end
+
+      def convert_ruby_to_js(value)
+        case value
+        when nil, true, false, Integer, Float
+          value
+        when String, Symbol
+          Truffle::Interop.as_truffle_string value
+        when Array
+          value.map { |e| convert_ruby_to_js(e) }
+        when Hash
+          h = @js_object.new
+          value.each_pair do |k,v|
+            h[convert_ruby_to_js(k)] = convert_ruby_to_js(v)
+          end
+          h
+        else
+          raise TypeError, "Unknown how to convert to JS: #{value.inspect}"
+        end
+      end
+
+      class_eval <<-'RUBY', "(execjs)", 1
+        def eval_in_context(code); @context.eval('js', code); end
+      RUBY
+    end
+
+    def name
+      "GraalVM (Graal.js)"
+    end
+
+    def available?
+      return @available if defined?(@available)
+
+      unless RUBY_ENGINE == "truffleruby"
+        return @available = false
+      end
+
+      unless defined?(Polyglot::InnerContext)
+        warn "TruffleRuby #{RUBY_ENGINE_VERSION} does not have support for inner contexts, use a more recent version", uplevel: 0 if $VERBOSE
+        return @available = false
+      end
+
+      unless Polyglot.languages.include? "js"
+        warn "The language 'js' is not available, you likely need to `export TRUFFLERUBYOPT='--jvm --polyglot'`", uplevel: 0 if $VERBOSE
+        warn "You also need to install the 'js' component, see https://github.com/oracle/truffleruby/blob/master/doc/user/polyglot.md#installing-other-languages", uplevel: 0 if $VERBOSE
+        return @available = false
+      end
+
+      @available = true
+    end
+  end
+end

data/lib/execjs/mini_racer_runtime.rb

@@ -4,7 +4,7 @@ module ExecJS
   class MiniRacerRuntime < Runtime
     class Context < Runtime::Context
       def initialize(runtime, source = "", options={})
-        source = encode(source)
+        source = source.encode(Encoding::UTF_8)
         @context = ::MiniRacer::Context.new
         @context.eval("delete this.console");
         translate do
@@ -13,7 +13,7 @@ module ExecJS
       end
 
       def exec(source, options = {})
-        source = encode(source)
+        source = source.encode(Encoding::UTF_8)
 
         if /\S/ =~ source
           eval "(function(){#{source}})()"
@@ -21,7 +21,7 @@ module ExecJS
       end
 
       def eval(source, options = {})
-        source = encode(source)
+        source = source.encode(Encoding::UTF_8)
 
         if /\S/ =~ source
           translate do

data/lib/execjs/module.rb

@@ -8,8 +8,6 @@ module ExecJS
   class RuntimeUnavailable < RuntimeError; end
 
   class << self
-    attr_reader :runtime
-
     def runtime=(runtime)
       raise RuntimeUnavailable, "#{runtime.name} is unavailable on this system" unless runtime.available?
       @runtime = runtime

data/lib/execjs/ruby_rhino_runtime.rb

@@ -1,10 +1,11 @@
 require "execjs/runtime"
+require "json"
 
 module ExecJS
   class RubyRhinoRuntime < Runtime
     class Context < Runtime::Context
       def initialize(runtime, source = "", options = {})
-        source = encode(source)
+        source = source.encode(Encoding::UTF_8)
 
         @rhino_context = ::Rhino::Context.new
         fix_memory_limit! @rhino_context
@@ -14,7 +15,7 @@ module ExecJS
       end
 
       def exec(source, options = {})
-        source = encode(source)
+        source = source.encode(Encoding::UTF_8)
 
         if /\S/ =~ source
           eval "(function(){#{source}})()", options
@@ -22,7 +23,7 @@ module ExecJS
       end
 
       def eval(source, options = {})
-        source = encode(source)
+        source = source.encode(Encoding::UTF_8)
 
         if /\S/ =~ source
           unbox @rhino_context.eval("(#{source})")
@@ -32,7 +33,11 @@ module ExecJS
       end
 
       def call(properties, *args)
-        unbox @rhino_context.eval(properties).call(*args)
+        # Might no longer be necessary if therubyrhino handles Symbols directly:
+        # https://github.com/rubyjs/therubyrhino/issues/43
+        converted_args = JSON.parse(JSON.generate(args), create_additions: false)
+
+        unbox @rhino_context.eval(properties).call(*converted_args)
       rescue Exception => e
         raise wrap_error(e)
       end

data/lib/execjs/runtime.rb

@@ -1,11 +1,7 @@
-require "execjs/encoding"
-
 module ExecJS
   # Abstract base class for runtimes
   class Runtime
     class Context
-      include Encoding
-
       def initialize(runtime, source = "", options = {})
       end
 

data/lib/execjs/runtimes.rb

@@ -4,6 +4,7 @@ require "execjs/duktape_runtime"
 require "execjs/external_runtime"
 require "execjs/ruby_rhino_runtime"
 require "execjs/mini_racer_runtime"
+require "execjs/graaljs_runtime"
 
 module ExecJS
   module Runtimes
@@ -13,6 +14,8 @@ module ExecJS
 
     RubyRhino = RubyRhinoRuntime.new
 
+    GraalJS = GraalJSRuntime.new
+
     MiniRacer = MiniRacerRuntime.new
 
     Node = ExternalRuntime.new(
@@ -22,6 +25,13 @@ module ExecJS
       encoding:    'UTF-8'
     )
 
+    Bun = ExternalRuntime.new(
+      name:        "Bun.sh",
+      command:     ["bun"],
+      runner_path: ExecJS.root + "/support/bun_runner.js",
+      encoding:    'UTF-8'
+    )
+
     JavaScriptCore = ExternalRuntime.new(
       name:        "JavaScriptCore",
       command:     [
@@ -82,8 +92,10 @@ module ExecJS
     def self.runtimes
       @runtimes ||= [
         RubyRhino,
+        GraalJS,
         Duktape,
         MiniRacer,
+        Bun,
         Node,
         JavaScriptCore,
         SpiderMonkey,

data/lib/execjs/support/bun_runner.js

@@ -0,0 +1,29 @@
+(function(program, execJS) { (function() {execJS(program) }).call({}); })(async function(self, global, process, module, exports, require, console, setTimeout, setInterval, clearTimeout, clearInterval, setImmediate, clearImmediate) { #{source}
+}, async function(program) {
+  // Force BunJS to use sloppy mode see https://github.com/oven-sh/bun/issues/4527#issuecomment-1709520894
+  exports.abc = function(){}
+  var __process__ = process;
+  var printFinal = function(string) {
+    Bun.write(Bun.stdout, '' + string).then(function() {
+      __process__.exit(0);
+    });
+  };
+  try {
+    delete this.process;
+    delete this.console;
+    result = await program();
+    process = __process__;
+    if (typeof result == 'undefined' && result !== null) {
+      printFinal('["ok"]');
+    } else {
+      try {
+        printFinal(JSON.stringify(['ok', result]));
+      } catch (err) {
+        printFinal(JSON.stringify(['err', '' + err, err.stack]));
+      }
+    }
+  } catch (err) {
+    process = __process__;
+    printFinal(JSON.stringify(['err', '' + err, err.stack]));
+  }
+});

data/lib/execjs/support/jsc_runner.js

@@ -3,6 +3,13 @@
   var output;
   try {
     delete this.console;
+    delete this.setTimeout;
+    delete this.setInterval;
+    delete this.clearTimeout;
+    delete this.clearInterval;
+    delete this.setImmediate;
+    delete this.clearImmediate;
+
     result = program();
     if (typeof result == 'undefined' && result !== null) {
       print('["ok"]');

data/lib/execjs/support/v8_runner.js

@@ -1,7 +1,14 @@
-(function(program, execJS) { execJS(program) })(function() { #{source}
+(function(program, execJS) { execJS(program) })(function(console, setTimeout, setInterval, clearTimeout, clearInterval, setImmediate, clearImmediate) { #{source}
 }, function(program) {
   var output;
   try {
+    delete this.console;
+    delete this.setTimeout;
+    delete this.setInterval;
+    delete this.clearTimeout;
+    delete this.clearInterval;
+    delete this.setImmediate;
+    delete this.clearImmediate;
     result = program();
     if (typeof result == 'undefined' && result !== null) {
       print('["ok"]');

data/lib/execjs/version.rb

@@ -1,3 +1,3 @@
 module ExecJS
-  VERSION = "2.8.1"
+  VERSION = "2.10.1"
 end

data/lib/execjs.rb

@@ -2,5 +2,7 @@ require "execjs/module"
 require "execjs/runtimes"
 
 module ExecJS
-  self.runtime ||= Runtimes.autodetect
+  def self.runtime
+    @runtime ||= Runtimes.autodetect
+  end
 end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: execjs
 version: !ruby/object:Gem::Version
-  version: 2.8.1
+  version: 2.10.1
 platform: ruby
 authors:
 - Sam Stephenson
 - Josh Peek
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-14 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -38,13 +37,14 @@ files:
 - lib/execjs.rb
 - lib/execjs/disabled_runtime.rb
 - lib/execjs/duktape_runtime.rb
-- lib/execjs/encoding.rb
 - lib/execjs/external_runtime.rb
+- lib/execjs/graaljs_runtime.rb
 - lib/execjs/mini_racer_runtime.rb
 - lib/execjs/module.rb
 - lib/execjs/ruby_rhino_runtime.rb
 - lib/execjs/runtime.rb
 - lib/execjs/runtimes.rb
+- lib/execjs/support/bun_runner.js
 - lib/execjs/support/jsc_runner.js
 - lib/execjs/support/jscript_runner.js
 - lib/execjs/support/json2.js
@@ -56,7 +56,6 @@ homepage: https://github.com/rails/execjs
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -64,15 +63,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.3
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
-signing_key:
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Run JavaScript code from Ruby
 test_files: []

data/lib/execjs/encoding.rb

@@ -1,26 +0,0 @@
-module ExecJS
-  # Encodes strings as UTF-8
-  module Encoding
-    if RUBY_ENGINE == 'jruby' || RUBY_ENGINE == 'rbx'
-      # workaround for jruby bug http://jira.codehaus.org/browse/JRUBY-6588
-      # workaround for rbx bug https://github.com/rubinius/rubinius/issues/1729
-      def encode(string)
-        if string.encoding.name == 'ASCII-8BIT'
-          data = string.dup
-          data.force_encoding('UTF-8')
-
-          unless data.valid_encoding?
-            raise ::Encoding::UndefinedConversionError, "Could not encode ASCII-8BIT data #{string.dump} as UTF-8"
-          end
-        else
-          data = string.encode('UTF-8')
-        end
-        data
-      end
-    else
-      def encode(string)
-        string.encode('UTF-8')
-      end
-    end
-  end
-end