Module: Opal

Defined in:
opal/opal/corelib/irb.rb,
opal/opal/corelib/helpers.rb more...

Overview

helpers: type_error, coerce_to

Defined Under Namespace

Modules: IRB

Class Method Summary collapse

Class Method Details

.bridge(constructor, klass) ⇒ Object

[View source]

4
5
6
 
# File 'opal/opal/corelib/helpers.rb', line 4

def self.bridge(constructor, klass)
  `Opal.bridge(constructor, klass)`
end

.class_variable_name!(name) ⇒ Object

[View source]

87
88
89
90
91
92
93
94
95
 
# File 'opal/opal/corelib/helpers.rb', line 87

def self.class_variable_name!(name)
  name = ::Opal.coerce_to!(name, ::String, :to_str)

  if `name.length < 3 || name.slice(0,2) !== '@@'`
    ::Kernel.raise ::NameError.new("`#{name}' is not allowed as a class variable name", name)
  end

  name
end

.coerce_to!(object, type, method, *args) ⇒ Object

[View source]

8
9
10
11
12
13
14
15
16
 
# File 'opal/opal/corelib/helpers.rb', line 8

def self.coerce_to!(object, type, method, *args)
  coerced = `$coerce_to(object, type, method, args)`

  unless type === coerced
    ::Kernel.raise `$type_error(object, type, method, coerced)`
  end

  coerced
end

.coerce_to?(object, type, method, *args) ⇒ Boolean

Returns:

[View source]

18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'opal/opal/corelib/helpers.rb', line 18

def self.coerce_to?(object, type, method, *args)
  return unless object.respond_to? method

  coerced = `$coerce_to(object, type, method, args)`

  return if coerced.nil?

  unless type === coerced
    ::Kernel.raise `$type_error(object, type, method, coerced)`
  end

  coerced
end

.compare(a, b) ⇒ Object

[View source]

40
41
42
43
44
45
46
47
48
 
# File 'opal/opal/corelib/helpers.rb', line 40

def self.compare(a, b)
  compare = a <=> b

  if `compare === nil`
    ::Kernel.raise ::ArgumentError, "comparison of #{a.class} with #{b.class} failed"
  end

  compare
end

.const_name!(const_name) ⇒ Object

[View source]

107
108
109
110
111
112
113
114
115
116
117
 
# File 'opal/opal/corelib/helpers.rb', line 107

def self.const_name!(const_name)
  const_name = ::Opal.coerce_to!(const_name, ::String, :to_str) if defined? ::String

  %x{
    if (!const_name || const_name[0] != const_name[0].toUpperCase()) {
      #{raise ::NameError, "wrong constant name #{const_name}"}
    }
  }

  const_name
end

.const_name?(const_name) ⇒ Boolean

Returns:

[View source]

97
98
99
100
101
102
103
104
105
 
# File 'opal/opal/corelib/helpers.rb', line 97

def self.const_name?(const_name)
  %x{
    if (typeof const_name !== 'string') {
      #{const_name = ::Opal.coerce_to!(const_name, ::String, :to_str)}
    }

    return #{const_name}[0] === #{const_name}[0].toUpperCase()
  }
end

.destructure(args) ⇒ Object

[View source]

50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
 
# File 'opal/opal/corelib/helpers.rb', line 50

def self.destructure(args)
  %x{
    if (args.length == 1) {
      return args[0];
    }
    else if (args.$$is_array) {
      return args;
    }
    else {
      var args_ary = new Array(args.length);
      for(var i = 0, l = args_ary.length; i < l; i++) { args_ary[i] = args[i]; }

      return args_ary;
    }
  }
end

.inspect(value = undefined) ⇒ String

Performs a safe call to inspect for any value, whether native or Opal-wrapped.

Parameters:

  • value (Object) (defaults to: undefined)

Returns:

[View source]

167
168
169
170
171
172
173
174
175
176
177
178
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
 
# File 'opal/opal/corelib/helpers.rb', line 167

def self.inspect(value = undefined)
  `var pushed = false`
  begin
    %x{
      if (value === null) {
        // JS null value
        return 'null';
      }
      else if (value === undefined) {
        // JS undefined value
        return 'undefined';
      }
      else if (typeof value.$$class === 'undefined') {
        // JS object / other value that is not bridged
        return Object.prototype.toString.apply(value);
      }
      else if (typeof value.$inspect !== 'function' || value.$inspect.$$stub) {
        // BasicObject and friends
        return #{"#<#{`value.$$class`}:0x#{value.__id__.to_s(16)}>"}
      }
      else if (inspect_stack.indexOf(#{value.__id__}) !== -1) {
        // inspect recursing inside inspect to find out about the
        // same object
        return #{"#<#{`value.$$class`}:0x#{value.__id__.to_s(16)}>"}
      }
      else {
        // anything supporting Opal
        inspect_stack.push(#{value.__id__});
        pushed = true;
        return value.$inspect();
      }
    }
    nil
  rescue ::Exception => e # rubocop:disable Lint/RescueException
    "#<#{`value.$$class`}:0x#{value.__id__.to_s(16)}>"
  ensure
    `if (pushed) inspect_stack.pop()`
  end
end

.instance_variable_name!(name) ⇒ Object

[View source]

77
78
79
80
81
82
83
84
85
 
# File 'opal/opal/corelib/helpers.rb', line 77

def self.instance_variable_name!(name)
  name = ::Opal.coerce_to!(name, ::String, :to_str)

  unless `/^@[a-zA-Z_][a-zA-Z0-9_]*?$/.test(name)`
    ::Kernel.raise ::NameError.new("'#{name}' is not allowed as an instance variable name", name)
  end

  name
end

.pristine(owner_class, *method_names) ⇒ nil

Mark some methods as pristine in order to apply optimizations when they are still in their original form. This could probably be moved to the Opal.def() JS API, but for now it will stay manual.

Examples:


Opal.pristine Array, :allocate, :copy_instance_variables, :initialize_dup

class Array
  def dup
    %x{
      if (
        self.$allocate.$$pristine &&
        self.$copy_instance_variables.$$pristine &&
        self.$initialize_dup.$$pristine
      ) return self.slice(0);
    }

    super
  end
end

Parameters:

  • owner_class (Class) —

    the class owning the methods

  • method_names (Array<Symbol>) —

    the list of methods names to mark

Returns:

  • (nil)
[View source]

145
146
147
148
149
150
151
152
153
154
155
156
157
158
 
# File 'opal/opal/corelib/helpers.rb', line 145

def self.pristine(owner_class, *method_names)
  %x{
    var method_name, method;
    for (var i = method_names.length - 1; i >= 0; i--) {
      method_name = method_names[i];
      method = owner_class.$$prototype[Opal.jsid(method_name)];

      if (method && !method.$$stub) {
        method.$$pristine = true;
      }
    }
  }
  nil
end

.respond_to?(obj, method, include_all = false) ⇒ Boolean

Returns:

[View source]

67
68
69
70
71
72
73
74
75
 
# File 'opal/opal/corelib/helpers.rb', line 67

def self.respond_to?(obj, method, include_all = false)
  %x{
    if (obj == null || !obj.$$class) {
      return false;
    }
  }

  obj.respond_to?(method, include_all)
end

.try_convert(object, type, method) ⇒ Object

[View source]

32
33
34
35
36
37
38
 
# File 'opal/opal/corelib/helpers.rb', line 32

def self.try_convert(object, type, method)
  return object if type === object

  if object.respond_to? method
    object.__send__ method
  end
end