Update WebIDL

1 files changed, 237 insertions, 109 deletions

diff --git a/components/script/dom/bindings/codegen/parser/tests/test_distinguishability.py b/components/script/dom/bindings/codegen/parser/tests/test_distinguishability.py
index 1fa12832d7f..e96026c2a09 100644
--- a/components/script/dom/bindings/codegen/parser/tests/test_distinguishability.py
+++ b/components/script/dom/bindings/codegen/parser/tests/test_distinguishability.py
@@ -1,8 +1,13 @@
+import traceback
+
+
 def firstArgType(method):
     return method.signatures()[0][1][0].type
 
+
 def WebIDLTest(parser, harness):
-    parser.parse("""
+    parser.parse(
+        """
       // Give our dictionary a required member so we don't need to
       // mess with optional and default values.
       dictionary Dict {
@@ -17,7 +22,8 @@ def WebIDLTest(parser, harness):
         undefined passNullableUnion((object? or DOMString) arg);
         undefined passNullable(Foo? arg);
       };
-    """)
+    """
+    )
     results = parser.finish()
 
     iface = results[2]
@@ -30,31 +36,38 @@ def WebIDLTest(parser, harness):
     dictType = firstArgType(dictMethod)
     ifaceType = firstArgType(ifaceMethod)
 
-    harness.ok(dictType.isDictionary(), "Should have dictionary type");
-    harness.ok(ifaceType.isInterface(), "Should have interface type");
-    harness.ok(ifaceType.isCallbackInterface(), "Should have callback interface type");
+    harness.ok(dictType.isDictionary(), "Should have dictionary type")
+    harness.ok(ifaceType.isInterface(), "Should have interface type")
+    harness.ok(ifaceType.isCallbackInterface(), "Should have callback interface type")
 
-    harness.ok(not dictType.isDistinguishableFrom(ifaceType),
-               "Dictionary not distinguishable from callback interface")
-    harness.ok(not ifaceType.isDistinguishableFrom(dictType),
-               "Callback interface not distinguishable from dictionary")
+    harness.ok(
+        not dictType.isDistinguishableFrom(ifaceType),
+        "Dictionary not distinguishable from callback interface",
+    )
+    harness.ok(
+        not ifaceType.isDistinguishableFrom(dictType),
+        "Callback interface not distinguishable from dictionary",
+    )
 
     nullableUnionType = firstArgType(nullableUnionMethod)
     nullableIfaceType = firstArgType(nullableIfaceMethod)
 
-    harness.ok(nullableUnionType.isUnion(), "Should have union type");
-    harness.ok(nullableIfaceType.isInterface(), "Should have interface type");
-    harness.ok(nullableIfaceType.nullable(), "Should have nullable type");
+    harness.ok(nullableUnionType.isUnion(), "Should have union type")
+    harness.ok(nullableIfaceType.isInterface(), "Should have interface type")
+    harness.ok(nullableIfaceType.nullable(), "Should have nullable type")
 
-    harness.ok(not nullableUnionType.isDistinguishableFrom(nullableIfaceType),
-               "Nullable type not distinguishable from union with nullable "
-               "member type")
-    harness.ok(not nullableIfaceType.isDistinguishableFrom(nullableUnionType),
-               "Union with nullable member type not distinguishable from "
-               "nullable type")
+    harness.ok(
+        not nullableUnionType.isDistinguishableFrom(nullableIfaceType),
+        "Nullable type not distinguishable from union with nullable " "member type",
+    )
+    harness.ok(
+        not nullableIfaceType.isDistinguishableFrom(nullableUnionType),
+        "Union with nullable member type not distinguishable from " "nullable type",
+    )
 
     parser = parser.reset()
-    parser.parse("""
+    parser.parse(
+        """
       interface TestIface {
         undefined passKid(Kid arg);
         undefined passParent(Parent arg);
@@ -70,7 +83,8 @@ def WebIDLTest(parser, harness):
       interface Grandparent {};
       interface Unrelated1 {};
       interface Unrelated2 {};
-    """)
+    """
+    )
     results = parser.finish()
 
     iface = results[0]
@@ -80,21 +94,26 @@ def WebIDLTest(parser, harness):
 
     for type1 in argTypes:
         for type2 in argTypes:
-            distinguishable = (type1 is not type2 and
-                               (type1 in unrelatedTypes or
-                                type2 in unrelatedTypes))
-
-            harness.check(type1.isDistinguishableFrom(type2),
-                          distinguishable,
-                          "Type %s should %sbe distinguishable from type %s" %
-                          (type1, "" if distinguishable else "not ", type2))
-            harness.check(type2.isDistinguishableFrom(type1),
-                          distinguishable,
-                          "Type %s should %sbe distinguishable from type %s" %
-                          (type2, "" if distinguishable else "not ", type1))
+            distinguishable = type1 is not type2 and (
+                type1 in unrelatedTypes or type2 in unrelatedTypes
+            )
+
+            harness.check(
+                type1.isDistinguishableFrom(type2),
+                distinguishable,
+                "Type %s should %sbe distinguishable from type %s"
+                % (type1, "" if distinguishable else "not ", type2),
+            )
+            harness.check(
+                type2.isDistinguishableFrom(type1),
+                distinguishable,
+                "Type %s should %sbe distinguishable from type %s"
+                % (type2, "" if distinguishable else "not ", type1),
+            )
 
     parser = parser.reset()
-    parser.parse("""
+    parser.parse(
+        """
       interface Dummy {};
       interface TestIface {
         undefined method(long arg1, TestIface arg2);
@@ -102,17 +121,19 @@ def WebIDLTest(parser, harness):
         undefined method(long arg1, Dummy arg2);
         undefined method(DOMString arg1, DOMString arg2, DOMString arg3);
       };
-    """)
+    """
+    )
     results = parser.finish()
-    harness.check(len(results[1].members), 1,
-                  "Should look like we have one method")
-    harness.check(len(results[1].members[0].signatures()), 4,
-                  "Should have four signatures")
+    harness.check(len(results[1].members), 1, "Should look like we have one method")
+    harness.check(
+        len(results[1].members[0].signatures()), 4, "Should have four signatures"
+    )
 
     parser = parser.reset()
     threw = False
     try:
-        parser.parse("""
+        parser.parse(
+            """
           interface Dummy {};
           interface TestIface {
             undefined method(long arg1, TestIface arg2);
@@ -120,19 +141,23 @@ def WebIDLTest(parser, harness):
             undefined method(any arg1,  Dummy arg2);
             undefined method(DOMString arg1, DOMString arg2, DOMString arg3);
           };
-        """)
+        """
+        )
         results = parser.finish()
     except:
         threw = True
 
-    harness.ok(threw,
-               "Should throw when args before the distinguishing arg are not "
-               "all the same type")
+    harness.ok(
+        threw,
+        "Should throw when args before the distinguishing arg are not "
+        "all the same type",
+    )
 
     parser = parser.reset()
     threw = False
     try:
-        parser.parse("""
+        parser.parse(
+            """
           interface Dummy {};
           interface TestIface {
             undefined method(long arg1, TestIface arg2);
@@ -140,7 +165,8 @@ def WebIDLTest(parser, harness):
             undefined method(any arg1,  DOMString arg2);
             undefined method(DOMString arg1, DOMString arg2, DOMString arg3);
           };
-        """)
+        """
+        )
         results = parser.finish()
     except:
         threw = True
@@ -148,57 +174,133 @@ def WebIDLTest(parser, harness):
     harness.ok(threw, "Should throw when there is no distinguishing index")
 
     # Now let's test our whole distinguishability table
-    argTypes = [ "long", "short", "long?", "short?", "boolean",
-                 "boolean?", "DOMString", "ByteString", "UTF8String", "Enum", "Enum2",
-                 "Interface", "Interface?",
-                 "AncestorInterface", "UnrelatedInterface", "CallbackInterface",
-                 "CallbackInterface?", "CallbackInterface2",
-                 "object", "Callback", "Callback2", "Dict",
-                 "Dict2", "sequence<long>", "sequence<short>",
-                 "record<DOMString, object>",
-                 "record<USVString, Dict>",
-                 "record<ByteString, long>",
-                 "record<UTF8String, long>",
-                 "any", "Promise<any>", "Promise<any>?",
-                 "USVString", "JSString", "ArrayBuffer", "ArrayBufferView",
-                 "Uint8Array", "Uint16Array",
-                 "(long or Callback)", "(long or Dict)",
+    argTypes = [
+        "long",
+        "short",
+        "long?",
+        "short?",
+        "boolean",
+        "boolean?",
+        "undefined",
+        "undefined?",
+        "DOMString",
+        "ByteString",
+        "UTF8String",
+        "Enum",
+        "Enum2",
+        "Interface",
+        "Interface?",
+        "AncestorInterface",
+        "UnrelatedInterface",
+        "CallbackInterface",
+        "CallbackInterface?",
+        "CallbackInterface2",
+        "object",
+        "Callback",
+        "Callback2",
+        "Dict",
+        "Dict2",
+        "sequence<long>",
+        "sequence<short>",
+        "record<DOMString, object>",
+        "record<USVString, Dict>",
+        "record<ByteString, long>",
+        "record<UTF8String, long>",
+        "any",
+        "Promise<any>",
+        "Promise<any>?",
+        "USVString",
+        "JSString",
+        "ArrayBuffer",
+        "ArrayBufferView",
+        "Uint8Array",
+        "Uint16Array",
+        "(long or Callback)",
+        "(long or Dict)",
     ]
 
     # Try to categorize things a bit to keep list lengths down
     def allBut(list1, list2):
-        return [a for a in list1 if a not in list2 and
-                (a != "any" and a != "Promise<any>" and a != "Promise<any>?")]
-    unions = [ "(long or Callback)", "(long or Dict)" ]
-    numerics = [ "long", "short", "long?", "short?" ]
-    booleans = [ "boolean", "boolean?" ]
+        return [
+            a
+            for a in list1
+            if a not in list2
+            and (a != "any" and a != "Promise<any>" and a != "Promise<any>?")
+        ]
+
+    unions = ["(long or Callback)", "(long or Dict)"]
+    numerics = ["long", "short", "long?", "short?"]
+    booleans = ["boolean", "boolean?"]
+    undefineds = ["undefined", "undefined?"]
     primitives = numerics + booleans
     nonNumerics = allBut(argTypes, numerics + unions)
     nonBooleans = allBut(argTypes, booleans)
-    strings = [ "DOMString", "ByteString", "Enum", "Enum2", "USVString", "JSString", "UTF8String" ]
+    strings = [
+        "DOMString",
+        "ByteString",
+        "Enum",
+        "Enum2",
+        "USVString",
+        "JSString",
+        "UTF8String",
+    ]
     nonStrings = allBut(argTypes, strings)
-    nonObjects = primitives + strings
-    objects = allBut(argTypes, nonObjects )
+    nonObjects = undefineds + primitives + strings
+    objects = allBut(argTypes, nonObjects)
     bufferSourceTypes = ["ArrayBuffer", "ArrayBufferView", "Uint8Array", "Uint16Array"]
-    interfaces = [ "Interface", "Interface?", "AncestorInterface",
-                   "UnrelatedInterface" ] + bufferSourceTypes
-    nullables = (["long?", "short?", "boolean?", "Interface?",
-                  "CallbackInterface?", "Dict", "Dict2",
-                  "Date?", "any", "Promise<any>?"] +
-                 allBut(unions, [ "(long or Callback)" ]))
-    sequences = [ "sequence<long>", "sequence<short>" ]
+    interfaces = [
+        "Interface",
+        "Interface?",
+        "AncestorInterface",
+        "UnrelatedInterface",
+    ] + bufferSourceTypes
+    nullables = [
+        "long?",
+        "short?",
+        "boolean?",
+        "undefined?",
+        "Interface?",
+        "CallbackInterface?",
+        "Dict",
+        "Dict2",
+        "Date?",
+        "any",
+        "Promise<any>?",
+    ] + allBut(unions, ["(long or Callback)"])
+    sequences = ["sequence<long>", "sequence<short>"]
     nonUserObjects = nonObjects + interfaces + sequences
     otherObjects = allBut(argTypes, nonUserObjects + ["object"])
-    notRelatedInterfaces = (nonObjects + ["UnrelatedInterface"] +
-                            otherObjects + sequences + bufferSourceTypes)
-    records = [ "record<DOMString, object>", "record<USVString, Dict>",
-                "record<ByteString, long>", "record<UTF8String, long>" ] # JSString not supported in records
+    notRelatedInterfaces = (
+        nonObjects
+        + ["UnrelatedInterface"]
+        + otherObjects
+        + sequences
+        + bufferSourceTypes
+    )
+    records = [
+        "record<DOMString, object>",
+        "record<USVString, Dict>",
+        "record<ByteString, long>",
+        "record<UTF8String, long>",
+    ]  # JSString not supported in records
+    dictionaryLike = (
+        [
+            "Dict",
+            "Dict2",
+            "CallbackInterface",
+            "CallbackInterface?",
+            "CallbackInterface2",
+        ]
+        + records
+        + allBut(unions, ["(long or Callback)"])
+    )
 
     # Build a representation of the distinguishability table as a dict
     # of dicts, holding True values where needed, holes elsewhere.
-    data = dict();
+    data = dict()
     for type in argTypes:
         data[type] = dict()
+
     def setDistinguishable(type, types):
         for other in types:
             data[type][other] = True
@@ -209,6 +311,10 @@ def WebIDLTest(parser, harness):
     setDistinguishable("short?", allBut(nonNumerics, nullables))
     setDistinguishable("boolean", nonBooleans)
     setDistinguishable("boolean?", allBut(nonBooleans, nullables))
+    setDistinguishable("undefined", allBut(argTypes, undefineds + dictionaryLike))
+    setDistinguishable(
+        "undefined?", allBut(argTypes, undefineds + dictionaryLike + nullables)
+    )
     setDistinguishable("DOMString", nonStrings)
     setDistinguishable("ByteString", nonStrings)
     setDistinguishable("UTF8String", nonStrings)
@@ -219,36 +325,44 @@ def WebIDLTest(parser, harness):
     setDistinguishable("Interface", notRelatedInterfaces)
     setDistinguishable("Interface?", allBut(notRelatedInterfaces, nullables))
     setDistinguishable("AncestorInterface", notRelatedInterfaces)
-    setDistinguishable("UnrelatedInterface",
-                       allBut(argTypes, ["object", "UnrelatedInterface"]))
-    setDistinguishable("CallbackInterface", nonUserObjects)
-    setDistinguishable("CallbackInterface?", allBut(nonUserObjects, nullables))
-    setDistinguishable("CallbackInterface2", nonUserObjects)
+    setDistinguishable(
+        "UnrelatedInterface", allBut(argTypes, ["object", "UnrelatedInterface"])
+    )
+    setDistinguishable("CallbackInterface", allBut(nonUserObjects, undefineds))
+    setDistinguishable(
+        "CallbackInterface?", allBut(nonUserObjects, nullables + undefineds)
+    )
+    setDistinguishable("CallbackInterface2", allBut(nonUserObjects, undefineds))
     setDistinguishable("object", nonObjects)
     setDistinguishable("Callback", nonUserObjects)
     setDistinguishable("Callback2", nonUserObjects)
-    setDistinguishable("Dict", allBut(nonUserObjects, nullables))
-    setDistinguishable("Dict2", allBut(nonUserObjects, nullables))
-    setDistinguishable("sequence<long>",
-                       allBut(argTypes, sequences + ["object"]))
-    setDistinguishable("sequence<short>",
-                       allBut(argTypes, sequences + ["object"]))
-    setDistinguishable("record<DOMString, object>", nonUserObjects)
-    setDistinguishable("record<USVString, Dict>", nonUserObjects)
+    setDistinguishable("Dict", allBut(nonUserObjects, nullables + undefineds))
+    setDistinguishable("Dict2", allBut(nonUserObjects, nullables + undefineds))
+    setDistinguishable("sequence<long>", allBut(argTypes, sequences + ["object"]))
+    setDistinguishable("sequence<short>", allBut(argTypes, sequences + ["object"]))
+    setDistinguishable("record<DOMString, object>", allBut(nonUserObjects, undefineds))
+    setDistinguishable("record<USVString, Dict>", allBut(nonUserObjects, undefineds))
     # JSString not supported in records
-    setDistinguishable("record<ByteString, long>", nonUserObjects)
-    setDistinguishable("record<UTF8String, long>", nonUserObjects)
+    setDistinguishable("record<ByteString, long>", allBut(nonUserObjects, undefineds))
+    setDistinguishable("record<UTF8String, long>", allBut(nonUserObjects, undefineds))
     setDistinguishable("any", [])
     setDistinguishable("Promise<any>", [])
     setDistinguishable("Promise<any>?", [])
     setDistinguishable("ArrayBuffer", allBut(argTypes, ["ArrayBuffer", "object"]))
-    setDistinguishable("ArrayBufferView", allBut(argTypes, ["ArrayBufferView", "Uint8Array", "Uint16Array", "object"]))
-    setDistinguishable("Uint8Array", allBut(argTypes, ["ArrayBufferView", "Uint8Array", "object"]))
-    setDistinguishable("Uint16Array", allBut(argTypes, ["ArrayBufferView", "Uint16Array", "object"]))
-    setDistinguishable("(long or Callback)",
-                       allBut(nonUserObjects, numerics))
-    setDistinguishable("(long or Dict)",
-                       allBut(nonUserObjects, numerics + nullables))
+    setDistinguishable(
+        "ArrayBufferView",
+        allBut(argTypes, ["ArrayBufferView", "Uint8Array", "Uint16Array", "object"]),
+    )
+    setDistinguishable(
+        "Uint8Array", allBut(argTypes, ["ArrayBufferView", "Uint8Array", "object"])
+    )
+    setDistinguishable(
+        "Uint16Array", allBut(argTypes, ["ArrayBufferView", "Uint16Array", "object"])
+    )
+    setDistinguishable("(long or Callback)", allBut(nonUserObjects, numerics))
+    setDistinguishable(
+        "(long or Dict)", allBut(nonUserObjects, numerics + nullables + undefineds)
+    )
 
     def areDistinguishable(type1, type2):
         return data[type1].get(type2, False)
@@ -271,10 +385,18 @@ def WebIDLTest(parser, harness):
           interface TestInterface {%s
           };
         """
-        methodTemplate = """
-            undefined myMethod(%s arg);"""
-        methods = (methodTemplate % type1) + (methodTemplate % type2)
+        if type1 in undefineds or type2 in undefineds:
+            methods = """
+                (%s or %s) myMethod();""" % (
+                type1,
+                type2,
+            )
+        else:
+            methodTemplate = """
+                undefined myMethod(%s arg);"""
+            methods = (methodTemplate % type1) + (methodTemplate % type2)
         idl = idlTemplate % methods
+
         parser = parser.reset()
         threw = False
         try:
@@ -284,11 +406,17 @@ def WebIDLTest(parser, harness):
             threw = True
 
         if areDistinguishable(type1, type2):
-            harness.ok(not threw,
-                       "Should not throw for '%s' and '%s' because they are distinguishable" % (type1, type2))
+            harness.ok(
+                not threw,
+                "Should not throw for '%s' and '%s' because they are distinguishable"
+                % (type1, type2),
+            )
         else:
-            harness.ok(threw,
-                       "Should throw for '%s' and '%s' because they are not distinguishable" % (type1, type2))
+            harness.ok(
+                threw,
+                "Should throw for '%s' and '%s' because they are not distinguishable"
+                % (type1, type2),
+            )
 
     # Enumerate over everything in both orders, since order matters in
     # terms of our implementation of distinguishability checks