execjs 2.8.1 → 2.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bd129488d607b71ba6aec4c087036583727f4114d632107be2297b96a6a20f2
-  data.tar.gz: fea27c5987305700a3c5adbbe8f2e282dc5d49e6c579d2c91369886739342c26
+  metadata.gz: 2cff0ab13dcd1bc38d12b1ca38d99773ba123ad75573c8b8f4789232677df308
+  data.tar.gz: a84d80b533fa677491bdb26d28bfedd44443deb5ff772d9eeb7db7e9e0d0ab36
 SHA512:
-  metadata.gz: 99fe4da9a1203aa378e4f73879db38d7f9737dedc92141c820e099229eac5d00e311ab56379d5a92ef41fa1323cedf2614ee2e971e0e5602096f30732aed1808
-  data.tar.gz: df6fb1647179df49bef56c5570fbc7148bfa1e290945e398482e369572764b60c1293c2220c6e3101d6bd9880d47d4084f2b1325c5f39d321a186ef4ec2ac639
+  metadata.gz: fbac63f192c113786e7df0bce663a0e40a241b54534e01f18047d356d7ccb1514e4aeb8a610a336f85271def9b5956404091caccf6f0c984a20a723f67a364ce
+  data.tar.gz: 2f6dfe9ff9154500ea26a0c94a829eacb8b63ac84744791eff8f0b8643182f30118b1f1ed42f08486a4cc05c4e61c0cb8d800df53dcbccdbba5dadb786027b7a

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:
 
@@ -37,6 +39,22 @@ 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 autodected 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
 
 ```

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,147 @@
+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 with 'gu install js' on GraalVM 22.2+", uplevel: 0 if $VERBOSE
+        warn "Note that you need TruffleRuby+GraalVM and not just the TruffleRuby standalone to use #{self.class}", 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/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({}); })(function(self, global, process, module, exports, require, console, setTimeout, setInterval, clearTimeout, clearInterval, setImmediate, clearImmediate) { #{source}
+}, 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) {
+    process.stdout.write('' + string, function() {
+      __process__.exit(0);
+    });
+  };
+  try {
+    delete this.process;
+    delete this.console;
+    result = 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.9.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: execjs
 version: !ruby/object:Gem::Version
-  version: 2.8.1
+  version: 2.9.1
 platform: ruby
 authors:
 - Sam Stephenson
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-05-14 00:00:00.000000000 Z
+date: 2023-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -38,13 +38,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
@@ -64,14 +65,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
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Run JavaScript code from Ruby

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