Class: Rhino::Ruby::Function

Inherits:
JS::BaseFunction
  • Object
show all
Includes:
JS::Wrapper, Scriptable
Defined in:
lib/rhino/ruby.rb

Direct Known Subclasses

Constructor

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Scriptable

access, access=, #get, #getIds, #has, #put

Constructor Details

#initialize(callable, scope) ⇒ Function

Returns a new instance of Function.



141
142
143
144
145
 
# File 'lib/rhino/ruby.rb', line 141

def initialize(callable, scope)
  super()
  @callable = callable
  JS::ScriptRuntime.setFunctionProtoAndParent(self, scope) if scope
end

Class Method Details

.wrap(callable, scope = nil) ⇒ Object

wrap a callable (Method/Proc)



135
136
137
138
139
 
# File 'lib/rhino/ruby.rb', line 135

def self.wrap(callable, scope = nil)
  # NOTE: include JS::Wrapper & Ruby.cache(callable.to_s) guarantees === 
  # in Rhino although if a bind Method gets passed it might get confusing
  Ruby.cache(callable.to_s) { new(callable, scope) }
end

Instance Method Details

#call(*args) ⇒ Object Also known as: __call__

override Object BaseFunction#call(Context context, Scriptable scope, Scriptable thisObj, Object args)



179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/rhino/ruby.rb', line 179

def call(*args)
  unless args.first.is_a?(JS::Context)
    return super # assume a Ruby #call
  end
  _, scope, this, args = *args # Java Function#call dispatch
  args = args.to_a # java.lang.Object[] -> Array
  # JS function style :
  if ( arity = @callable.arity ) != -1 # (a1, *a).arity == -2
    if arity > -1 && args.size > arity # omit 'redundant' arguments
      args = args.slice(0, arity)
    elsif arity > args.size || # fill 'missing' arguments
        ( arity < -1 && (arity = arity.abs - 1) > args.size )
      (arity - args.size).times { args.push(nil) }
    end
  end
  rb_args = Rhino.args_to_ruby(args)
  begin
    callable = 
      if @callable.is_a?(UnboundMethod)
        @callable.bind(Rhino.to_ruby(this)) # might end up as TypeError
      else
        @callable
      end
    result = callable.call(*rb_args)
  rescue StandardError, ScriptError => e
    raise Ruby.wrap_error(e) # thus `try { } catch (e)` works in JS
  end
  Rhino.to_javascript(result, scope)
end

#equivalentValues(other) ⇒ Object Also known as: ==

protected Object ScriptableObject#equivalentValues(Object value)



168
169
170
171
172
173
174
 
# File 'lib/rhino/ruby.rb', line 168

def equivalentValues(other) # JS == operator
  return false unless other.is_a?(Function)
  return true if unwrap == other.unwrap
  # Method.== does check if their bind to the same object
  # JS == means they might be bind to different objects :
  unwrap.to_s == other.unwrap.to_s # "#<Method: Foo#bar>"
end

#getArity ⇒ Object

#deprecated int BaseFunction#getArity()



158
159
160
 
# File 'lib/rhino/ruby.rb', line 158

def getArity
  getLength
end

#getFunctionName ⇒ Object

override String BaseFunction#getFunctionName()



163
164
165
 
# File 'lib/rhino/ruby.rb', line 163

def getFunctionName
  @callable.is_a?(Proc) ? "" : @callable.name
end

#getLength ⇒ Object

override int BaseFunction#getLength()



152
153
154
155
 
# File 'lib/rhino/ruby.rb', line 152

def getLength
  arity = @callable.arity
  arity < 0 ? ( arity + 1 ).abs : arity
end

#unwrap ⇒ Object 



147
148
149
 
# File 'lib/rhino/ruby.rb', line 147

def unwrap
  @callable
end