minjs 0.3.0 → 0.4.0

data/lib/minjs/ecma262/{lit.rb → literal.rb}

@@ -2,90 +2,145 @@
 require 'set'
 module Minjs
   module ECMA262
+    # Base class of ECMA262 Literal
     class Literal < Base
+      #true if literal is white space
       def ws?
         false
       end
 
+      #true if literal is line terminator
       def lt?
         false
       end
 
-      def to_exp?
-        false
+      # Returns this node has side effect or not.
+      # @return [Boolean]
+      def side_effect?
+        true
       end
 
+      # @return [Fixnum] expression priority
       def priority
         PRIORITY_PRIMARY
       end
     end
 
+    # Class of psedo element.
+    #
+    # This class means element is division punctuator or regular expression literal,
+    # but lexical parser cannot determine which of them.
+    #
     class DivOrRegexpLiteral < Literal
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and self.val == obj.val
       end
 
-      def to_js(options = {})
-        "??"
-      end
-
       @@instance = self.new()
+
+      # get instance
       def self.get
         @@instance
       end
+      private_class_method :new
     end
 
+    # DivOrRegexpLiteral
     LIT_DIV_OR_REGEXP_LITERAL = DivOrRegexpLiteral.get
 
+    # Class of ECMA262 WhiteSpace element
+    #
+    # Every WhiteSpace characters in source elements is
+    # converted to this class object.
+    #
+    # This class is singleton and representation string is \u0020.
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.2
     class WhiteSpace < Literal
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
       end
 
+      #true if literal is white space
       def ws?
         true
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         " "
       end
 
       @@instance = self.new()
+
+      # get instance
       def self.get
         @@instance
       end
+      private_class_method :new
     end
 
-    class LineFeed < Literal
+    # Class of ECMA262 LineTerminator element
+    #
+    # Every LineTerminator characters in source elements is
+    # converted to this class object.
+    #
+    # This class is singleton and representation string is \u000A.
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.3
+    class LineTerminator < Literal
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
       end
 
+      #true if literal is line terminator
       def lt?
         true
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         "\n"
       end
 
       @@instance = self.new()
+
+      # get instance
       def self.get
         @@instance
       end
+      private_class_method :new
     end
 
-    LIT_LINE_FEED = LineFeed.get
+    # line feed ("\n") element
+    LIT_LINE_TERMINATOR = LineTerminator.get
 
+    # Class of ECMA262 'this' element
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 11.1.1
     class This < Literal
       attr_reader :context
 
@@ -93,82 +148,133 @@ module Minjs
         @context = context
       end
 
+      # duplicate object
+      # @see Base#deep_dup
       def deep_dup
         self.class.new(@context)
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
-        yield self, parent
-      end
-
-      def to_s
-        "this"
+        yield parent, self
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         "this"
       end
 
+      # @return [Boolean] true if expression is kind of LeftHandSideExpression.
       def left_hand_side_exp?
         true
       end
     end
 
+    # Class of ECMA262 Null element
+    #
+    # Every Null literal in source elements is
+    # converted to this class object.
+    #
+    # This class is singleton
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.8.1
     class Null < Literal
       def initialize(val)
         @val = :null
       end
 
+      # duplicate object
+      # @see Base#deep_dup
       def deep_dup
         self #not dup
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
-        yield self, parent
-      end
-
-      def to_s
-        "null"
+        yield parent, self
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         "null"
       end
 
+      # @return [Boolean] true if expression is kind of LeftHandSideExpression.
       def left_hand_side_exp?
         true
       end
 
       @@instance = self.new(nil)
+
+      # get instance
       def self.get
         @@instance
       end
 
+      # Returns results of ToBoolean()
+      #
+      # Returns _true_ or _false_ if trivial,
+      # otherwise nil.
+      #
+      # @return [Boolean]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.2
       def to_ecma262_boolean
         false
       end
 
+      # Returns results of ToString()
+      #
+      # Returns string if value is trivial,
+      # otherwise nil.
+      #
+      # @return [Numeric]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.8
       def to_ecma262_string
         "null"
       end
 
+      # Returns results of ToNumber()
+      #
+      # Returns number if value is trivial,
+      # otherwise nil.
+      #
+      # @return [Numeric]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.3
       def to_ecma262_number
         0
       end
 
+      # return results of 'typeof' operator.
+      #
+      # @return [Symbol] :boolean
       def ecma262_typeof
         :boolean
       end
+      private_class_method :new
     end
 
+    # Class of ECMA262 Boolean element
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.8.2
     class Boolean < Literal
       attr_reader :val
 
@@ -180,23 +286,32 @@ module Minjs
         end
       end
 
+      # duplicate object
+      # @see Base#deep_dup
       def deep_dup
         self #//not dup
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
-        yield self, parent
+        yield parent, self
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and
           @val == obj.val
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         @val.to_s
       end
 
+      # @return [Boolean] true if expression is kind of LeftHandSideExpression.
       def left_hand_side_exp?
         true
       end
@@ -205,6 +320,14 @@ module Minjs
         @val == :true
       end
 
+      # Returns results of ToString()
+      #
+      # Returns string if value is trivial,
+      # otherwise nil.
+      #
+      # @return [Numeric]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.8
       def to_ecma262_string
         if @val == :false
           "false"
@@ -213,6 +336,14 @@ module Minjs
         end
       end
 
+      # Returns results of ToBoolean()
+      #
+      # Returns _true_ or _false_ if trivial,
+      # otherwise nil.
+      #
+      # @return [Boolean]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.2
       def to_ecma262_boolean
         if @val == :false
           false
@@ -221,6 +352,14 @@ module Minjs
         end
       end
 
+      # Returns results of ToNumber()
+      #
+      # Returns number if value is trivial,
+      # otherwise nil.
+      #
+      # @return [Numeric]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.3
       def to_ecma262_number
         if @val == :false
           0
@@ -229,12 +368,17 @@ module Minjs
         end
       end
 
+      # return results of 'typeof' operator.
+      #
+      # @return [Symbol] :boolean
       def ecma262_typeof
         :boolean
       end
 
       @@true = self.new(:true)
       @@false = self.new(:false)
+
+      # get instance
       def self.get(val)
         if val.to_sym == :true || val == true
           @@true
@@ -243,7 +387,17 @@ module Minjs
         end
       end
     end
+    # *true* literal
+    LITERAL_TRUE = Boolean.new(:true)
+    # *false* literal
+    LITERAL_FALSE = Boolean.new(:false)
+    Boolean.class_eval {
+      private_class_method :new
+    }
 
+    # Class of ECMA262 String element
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.8.4
     class ECMA262String < Literal
       include Ctype
       attr_reader :val
@@ -252,18 +406,26 @@ module Minjs
         @val = val
       end
 
+      # duplicate object
+      # @see Base#deep_dup
       def deep_dup
         self.class.new(@val)
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent)
-        yield self, parent
+        yield parent, self
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and @val == obj.val
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         dq = @val.to_s.each_codepoint.select{|x| x == 0x22}.length
         sq = @val.to_s.each_codepoint.select{|x| x == 0x27}.length
@@ -309,10 +471,19 @@ module Minjs
         end
       end
 
+      # @return [Boolean] true if expression is kind of LeftHandSideExpression.
       def left_hand_side_exp?
         true
       end
 
+      # Returns results of ToBoolean()
+      #
+      # Returns _true_ or _false_ if trivial,
+      # otherwise nil.
+      #
+      # @return [Boolean]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.2
       def to_ecma262_boolean
         if @val.length == 0
           false
@@ -321,10 +492,25 @@ module Minjs
         end
       end
 
+      # Returns results of ToString()
+      #
+      # Returns string if value is trivial,
+      # otherwise nil.
+      #
+      # @return [Numeric]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.8
       def to_ecma262_string
         @val.dup
       end
-      # 9.3.1 ToNumber Applied to the String Type
+      # Returns results of ToNumber()
+      #
+      # Returns number if value is trivial,
+      # otherwise nil.
+      #
+      # @return [Numeric]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.3
       def to_ecma262_number
         begin
           pos1 = pos0 = pos = 0
@@ -425,13 +611,21 @@ module Minjs
         ret
       end
 
+      # return results of 'typeof' operator.
+      #
+      # @return [Symbol] :string
       def ecma262_typeof
         :string
       end
+
+      # Returns this node has side effect or not.
+      # @return [Boolean]
+      def side_effect?
+        return false
+      end
     end
 
-    #
-    # 8.5 The Number Type
+    # Class of ECMA262 Numeric element
     #
     # ECMA262 say:
     #
@@ -444,6 +638,7 @@ module Minjs
     # To simplify the implementation,
     # Minjs assumes that ruby has IEEE754 dobule precision.
     #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.8.3
     class ECMA262Numeric < Literal
       attr_reader :integer, :decimal, :exp, :number
 
@@ -522,18 +717,26 @@ module Minjs
         end
       end
 
+      # duplicate object
+      # @see Base#deep_dup
       def deep_dup
         self.class.new(@number)
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
-        yield self, parent
+        yield parent, self
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and self.to_ecma262_string == obj.to_ecma262_string
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         if nan?
           return "NaN"
@@ -572,33 +775,44 @@ module Minjs
         t.length <= t0.length ? t : t0
       end
 
+      # @return [Boolean] true if expression is kind of LeftHandSideExpression.
       def left_hand_side_exp?
         true
       end
 
+      # to integer
       def to_i
         to_ecma262_string.to_i
       end
 
+      # to float
       def to_f
         to_ecma262_string.to_f
       end
 
+      # True if number is NaN
       def nan?
         @number.kind_of? Float and @number.nan?
       end
 
+      # True if number is Infinity
       def infinity?
         @number == Float::INFINITY || @number == -Float::INFINITY
       end
 
+      # True if number not Infinity nor NaN
       def number?
         !nan? and !infinity?
       end
 
+      # Returns results of ToString()
       #
-      # 9.8.1
+      # Returns string if value is trivial,
+      # otherwise nil.
       #
+      # @return [Numeric]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.8
       def to_ecma262_string
         if nan?
           "NaN"
@@ -637,6 +851,14 @@ module Minjs
         end
       end
 
+      # Returns results of ToBoolean()
+      #
+      # Returns _true_ or _false_ if value is trivial,
+      # otherwise nil.
+      #
+      # @return [Boolean]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.2
       def to_ecma262_boolean
         if @val == :nan or to_ecma262_string == "0"
           false
@@ -645,6 +867,20 @@ module Minjs
         end
       end
 
+      # Returns this node has side effect or not.
+      # @return [Boolean]
+      def side_effect?
+        return false
+      end
+
+      # Returns results of ToNumber()
+      #
+      # Returns number if value is trivial,
+      # otherwise nil.
+      #
+      # @return [Numeric]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.3
       def to_ecma262_number
         if nan?
           nil
@@ -657,21 +893,29 @@ module Minjs
         end
       end
 
+      # return results of 'typeof' operator.
+      #
+      # @return [Symbol] :number
       def ecma262_typeof
         :number
       end
 
-      def ecma262_eval(type)
-        case type
-        when :boolean
-          to_ecma262_boolean
-        else
-          nil
-        end
-      end
+#      def ecma262_eval(type)
+#        case type
+#        when :boolean
+#          to_ecma262_boolean
+#        else
+#          nil
+#        end
+#      end
     end
+
+    #NaN element
     NUMERIC_NAN = ECMA262Numeric.new(:nan)
 
+    # Class of ECMA262 RegExp element
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.8.5
     class ECMA262RegExp < Literal
       attr_reader :body, :flags
 
@@ -680,34 +924,51 @@ module Minjs
         @flags = flags
       end
 
+      # duplicate object
+      # @see Base#deep_dup
       def deep_dup
         self.class.new(@body, @flags)
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent)
-        yield self, parent
+        yield parent, self
       end
 
+      # Returns results of ToBoolean()
+      #
+      # Returns _true_ or _false_ if trivial,
+      # otherwise nil.
+      #
+      # @return [Boolean]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.2
       def to_ecma262_boolean
         true
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and @body == obj.body and @flags == obj.flags
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         "/#{@body}/#{@flags}"
       end
 
+      # @return [Boolean] true if expression is kind of LeftHandSideExpression.
       def left_hand_side_exp?
         true
       end
     end
 
-    LITERAL_TRUE = Boolean.new(:true)
-    LITERAL_FALSE = Boolean.new(:false)
-
+    # Class of ECMA262 Array element
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 11.1.4
     class ECMA262Array < Literal
       attr_reader :val
 
@@ -715,34 +976,54 @@ module Minjs
         @val = val # val is Array
       end
 
+      # duplicate object
+      # @see Base#deep_dup
       def deep_dup
         self.class.new(@val.collect{|x| x ? x.deep_dup : nil})
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
-        yield self, parent
+        yield parent, self
         @val.each do |k|
           k.traverse(parent, &block) if k
         end
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and @val == obj.val
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         "[" + @val.collect{|x| x.to_s}.join(",") + "]"
       end
 
+      # @return [Boolean] true if expression is kind of LeftHandSideExpression.
       def left_hand_side_exp?
         true
       end
 
+      # Returns results of ToBoolean()
+      #
+      # Returns _true_ or _false_ if trivial,
+      # otherwise nil.
+      #
+      # @return [Boolean]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.2
       def to_ecma262_boolean
         true
       end
     end
 
+    # Class of ECMA262 Array element
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 11.1.5
     class ECMA262Object < Literal
       include Ctype
       attr_reader :val
@@ -752,22 +1033,30 @@ module Minjs
         @val = val
       end
 
+      # duplicate object
+      # @see Base#deep_dup
       def deep_dup
         self.class.new(@val.collect{|x, y| [x.deep_dup, y ? y.deep_dup : y]})
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
-        yield self, parent
+        yield parent, self
         @val.each do |k, v|
           k.traverse(parent, &block)
           v.traverse(parent, &block)
         end
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and @val == obj.val
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         concat(options, "{" + @val.collect{|x, y|
                  if y.kind_of? StFunc and (y.getter? || y.setter?)
@@ -788,37 +1077,59 @@ module Minjs
                }.join(","), "}")
       end
 
+      # @return [Boolean] true if expression is kind of LeftHandSideExpression.
       def left_hand_side_exp?
         true
       end
 
+      # Returns results of ToBoolean()
+      #
+      # Returns _true_ or _false_ if trivial,
+      # otherwise nil.
+      #
+      # @return [Boolean]
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 9.2
       def to_ecma262_boolean
         true
       end
     end
 
+    # Class of ECMA262 SingleLineComment Element
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.4
     class SingleLineComment < Literal
       def initialize(comment)
         @comment = comment
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and
           @comment == obj.comment
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options)
         "//#{@comment}"
       end
 
+      #true if literal is white space
       def ws?
         true
       end
     end
 
+    # Class of ECMA262 MultiLineComment Element
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.4
     class MultiLineComment < Literal
       attr_reader :comment, :has_lf
       include Ctype
@@ -827,21 +1138,33 @@ module Minjs
         @comment = comment
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent, &block)
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and @comment == obj.comment
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options)
         "/*#{@comment}*/"
       end
 
+      #true if literal is white space
       def ws?
         !lt?
       end
 
+      #true if literal is line terminator
+      #
+      # If MultiLineComment has one more LineTerminator,
+      # This comment is kind of line terminator.
+      # otherwise, this comment is kind of white space.
       def lt?
         @comment.codepoints.each{|char|
           return true if line_terminator?(char)
@@ -850,6 +1173,9 @@ module Minjs
       end
     end
 
+    # Class of ECMA262 IdentifierName Element
+    #
+    # @see http://www.ecma-international.org/ecma-262 ECMA262 7.6
     class IdentifierName < Literal
       attr_accessor :context
       attr_reader :val
@@ -861,6 +1187,7 @@ module Minjs
         @val = val.to_sym
       end
 
+      # get instance
       def self.get(context, val)
         if reserved?(val)
           @@sym[val] ||= self.new(context, val)
@@ -869,44 +1196,68 @@ module Minjs
         end
       end
 
+      # reserved word list
+      #
+      # @see http://www.ecma-international.org/ecma-262 ECMA262 7.6.1
       RESERVED_WORD = Set.new [
-        :break, :do, :instanceof, :typeof, :case, :else,
-        :new, :var, :catch, :finally, :return, :void, :continue,
-        :for, :switch, :while,:debugger, :function, :this, :with,
-        :default, :if, :throw, :delete, :in, :try,
-        :class, :enum, :extends, :super, :const, :export, :import,
-        :implements, :let, :private, :public, :yield,
-        :interface, :package, :protected, :static,
+        #keywords
+        :break, :do, :instanceof, :typeof,
+        :case, :else, :new, :var,
+        :catch, :finally, :return, :void,
+        :continue, :for, :switch, :while,
+        :debugger, :function, :this, :with,
+        :default, :if, :throw,
+        :delete, :in, :try,
+        #future reserved words
+        :class, :enum, :extends, :super,
+        :const, :export, :import,
+        #future reserved words(strict mode) (TODO)
+        #:implements, :let, :private, :public, :yield,
+        #:interface, :package, :protected, :static,
         :null, :false, :true
       ]
+
+      # Returns true if this literal is reserved word.
       def reserved?
         RESERVED_WORD.include?(val)
       end
 
+      # Returns true if *val* is reserved word.
+      # @param val [String] value
       def self.reserved?(val)
         RESERVED_WORD.include?(val)
       end
 
+      # Traverses this children and itself with given block.
+      #
+      # @see Base#traverse
       def traverse(parent)
-        yield self, parent
+        yield parent, self
       end
 
+      # duplicate object
+      # @see Base#deep_dup
       def deep_dup
         self.class.new(@context, @val)
       end
 
+      # compare object
       def ==(obj)
         self.class == obj.class and self.val == obj.val
       end
 
+      # Returns a ECMAScript string containg the representation of element.
+      # @see Base#to_js
       def to_js(options = {})
         val.to_s
       end
 
+      # @return [Boolean] true if expression is kind of LeftHandSideExpression.
       def left_hand_side_exp?
         true
       end
 
+      # @return [EnvRecord] binding environment
       def binding_env(type = :var)
         return nil if context.nil?
         if type == :var
@@ -926,37 +1277,67 @@ module Minjs
       end
     end
 
+    # reserved word "this"
     ID_THIS = IdentifierName.get(nil, :this)
+    # reserved word "var"
     ID_VAR = IdentifierName.get(nil, :var)
+    # reserved word "in"
     ID_IN = IdentifierName.get(nil, :in)
+    # reserved word "instanceof"
     ID_INSTANCEOF = IdentifierName.get(nil, :instanceof)
+    # reserved word "function"
     ID_FUNCTION = IdentifierName.get(nil, :function)
+    # reserved word "null"
     ID_NULL = IdentifierName.get(nil, :null)
+    # reserved word "true"
     ID_TRUE = IdentifierName.get(nil, :true)
+    # reserved word "false"
     ID_FALSE = IdentifierName.get(nil, :false)
+    # reserved word "new"
     ID_NEW = IdentifierName.get(nil, :new)
+    # reserved word "delete"
     ID_DELETE = IdentifierName.get(nil, :delete)
+    # reserved word "void"
     ID_VOID = IdentifierName.get(nil, :void)
+    # reserved word "typeof"
     ID_TYPEOF = IdentifierName.get(nil, :typeof)
+    # reserved word "if"
     ID_IF = IdentifierName.get(nil, :if)
+    # reserved word "else"
     ID_ELSE = IdentifierName.get(nil, :else)
+    # reserved word "for"
     ID_FOR = IdentifierName.get(nil, :for)
+    # reserved word "while"
     ID_WHILE = IdentifierName.get(nil, :while)
+    # reserved word "do"
     ID_DO = IdentifierName.get(nil, :do)
+    # reserved word "continue"
     ID_CONTINUE = IdentifierName.get(nil, :continue)
+    # reserved word "break"
     ID_BREAK = IdentifierName.get(nil, :break)
+    # reserved word "return"
     ID_RETURN = IdentifierName.get(nil, :return)
+    # reserved word "with"
     ID_WITH = IdentifierName.get(nil, :with)
+    # reserved word "switch"
     ID_SWITCH = IdentifierName.get(nil, :switch)
+    # reserved word "throw"
     ID_THROW = IdentifierName.get(nil, :throw)
+    # reserved word "try"
     ID_TRY = IdentifierName.get(nil, :try)
+    # reserved word "catch"
     ID_CATCH = IdentifierName.get(nil, :catch)
+    # reserved word "finally"
     ID_FINALLY = IdentifierName.get(nil, :finally)
+    # reserved word "debugger"
     ID_DEBUGGER = IdentifierName.get(nil, :debugger)
+    # reserved word "case"
     ID_CASE = IdentifierName.get(nil, :case)
+    # reserved word "default"
     ID_DEFAULT = IdentifierName.get(nil, :default)
-    # Note: get and set are not reserved word
+    # get (non-reserved word)
     ID_GET = IdentifierName.get(nil, :get)
+    # set (non-reserved word)
     ID_SET = IdentifierName.get(nil, :set)
 
   end