HTMLConstructor implementation

third_party/WebKit/Source/bindings/scripts/idl_definitions.py

 # Copyright (C) 2013 Google Inc. All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without
 # modification, are permitted provided that the following conditions are
 # met:
 #
 #     * Redistributions of source code must retain the above copyright
 # notice, this list of conditions and the following disclaimer.
 #     * Redistributions in binary form must reproduce the above
 # copyright notice, this list of conditions and the following disclaimer
@@ skipping 277 matching lines @@
 # Interfaces and Exceptions
 ################################################################################
 
 class IdlInterface(object):
     def __init__(self, idl_name, node=None):
         self.attributes = []
         self.constants = []
         self.constructors = []
         self.custom_constructors = []
         self.extended_attributes = {}
+        self.html_constructors = []
         self.operations = []
         self.parent = None
         self.serializer = None
         self.stringifier = None
         self.iterable = None
         self.has_indexed_elements = False
         self.maplike = None
         self.setlike = None
         self.original_interface = None
         self.partial_interfaces = []
@@ skipping 16 matching lines @@
             child_class = child.GetClass()
             if child_class == 'Attribute':
                 attr = IdlAttribute(idl_name, child)
                 if attr.idl_type.is_integer_type and attr.name == 'length':
                     has_integer_typed_length = True
                 self.attributes.append(attr)
             elif child_class == 'Const':
                 self.constants.append(IdlConstant(idl_name, child))
             elif child_class == 'ExtAttributes':
                 extended_attributes = ext_attributes_node_to_extended_attributes(idl_name, child)
-                self.constructors, self.custom_constructors = (
+                self.constructors, self.custom_constructors, self.html_constructors = (
                     extended_attributes_to_constructors(idl_name, extended_attributes))
                 clear_constructor_attributes(extended_attributes)
                 self.extended_attributes = extended_attributes
             elif child_class == 'Operation':
                 op = IdlOperation(idl_name, child)
                 if 'getter' in op.specials and str(op.arguments[0].idl_type) == 'unsigned long':
                     has_indexed_property_getter = True
                 self.operations.append(op)
             elif child_class == 'Inherit':
                 self.parent = child.GetName()
@@ skipping 82 matching lines @@
         children = node.GetChildren()
         for child in children:
             child_class = child.GetClass()
             if child_class == 'Attribute':
                 attribute = IdlAttribute(idl_name, child)
                 self.attributes.append(attribute)
             elif child_class == 'Const':
                 self.constants.append(IdlConstant(idl_name, child))
             elif child_class == 'ExtAttributes':
                 extended_attributes = ext_attributes_node_to_extended_attributes(idl_name, child)
-                self.constructors, self.custom_constructors = (
+                self.constructors, self.custom_constructors, self.html_constructors = (
                     extended_attributes_to_constructors(idl_name, extended_attributes))
                 clear_constructor_attributes(extended_attributes)
                 self.extended_attributes = extended_attributes
             elif child_class == 'ExceptionOperation':
                 self.operations.append(IdlOperation.from_exception_operation_node(idl_name, child))
             else:
                 raise ValueError('Unrecognized node class: %s' % child_class)
 
 
 ################################################################################
@@ skipping 513 matching lines @@
     constructor_list = extended_attributes.get('Constructors', [])
     constructors = [
         IdlOperation.constructor_from_arguments_node('Constructor', idl_name, arguments_node)
         for arguments_node in constructor_list]
 
     custom_constructor_list = extended_attributes.get('CustomConstructors', [])
     custom_constructors = [
         IdlOperation.constructor_from_arguments_node('CustomConstructor', idl_name, arguments_node)
         for arguments_node in custom_constructor_list]
 
+    if 'HTMLConstructor' in extended_attributes:
+        html_constructors = [IdlOperation.constructor_from_arguments_node('HTMLConstructor', idl_name, None)]

[bashi, 2016/10/04 05:53:51]

Could you help me understand why we need to use a list here?

- If there are more than one HTMLConstructors, this seems not correct (Ignoring
some constructors?).
- If there is only one HTMLConstructor, we can store it directly.

Also, why do we need to store |html_constructors| in IdlInterface?

+    else:
+        html_constructors = []
+
     if 'NamedConstructor' in extended_attributes:
         # FIXME: support overloaded named constructors, and make homogeneous
         name = 'NamedConstructor'
         call_node = extended_attributes['NamedConstructor']
         extended_attributes['NamedConstructor'] = call_node.GetName()
         children = call_node.GetChildren()
         if len(children) != 1:
             raise ValueError('NamedConstructor node expects 1 child, got %s.' % len(children))
         arguments_node = children[0]
         named_constructor = IdlOperation.constructor_from_arguments_node('NamedConstructor', idl_name, arguments_node)
         # FIXME: should return named_constructor separately; appended for Perl
         constructors.append(named_constructor)
 
-    return constructors, custom_constructors
+    return constructors, custom_constructors, html_constructors
 
 
 def clear_constructor_attributes(extended_attributes):
     # Deletes Constructor*s* (plural), sets Constructor (singular)
     if 'Constructors' in extended_attributes:
         del extended_attributes['Constructors']
         extended_attributes['Constructor'] = None
     if 'CustomConstructors' in extended_attributes:
         del extended_attributes['CustomConstructors']
         extended_attributes['CustomConstructor'] = None
@@ skipping 131 matching lines @@
         self.visit_typed_object(argument)
 
     def visit_iterable(self, iterable):
         self.visit_typed_object(iterable)
 
     def visit_maplike(self, maplike):
         self.visit_typed_object(maplike)
 
     def visit_setlike(self, setlike):
         self.visit_typed_object(setlike)