IDL compiler: addEventListener, removeEventListener methods

Source/bindings/tests/idls/TestObjectPython.idl

 /*
  * 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
@@ skipping 34 matching lines @@
     attribute byte byteAttribute;
     attribute double doubleAttribute;
     attribute float floatAttribute;
     attribute long longAttribute;
     attribute long long longLongAttribute;
     attribute octet octetAttribute;
     attribute short shortAttribute;
     attribute unsigned long unsignedLongAttribute;
     attribute unsigned long long unsignedLongLongAttribute;
     attribute unsigned short unsignedShortAttribute;
-    // Special names (start with acronym)
+    // Names that with an acronym
     attribute long cssAttribute;
     attribute long imeAttribute;
     attribute long svgAttribute;
     attribute long xmlAttribute;
     // Non-wrapper types
     attribute NodeFilter nodeFilterAttribute;
     attribute SerializedScriptValue serializedScriptValueAttribute;
     attribute any anyAttribute;
-    // Special type conversions
+    // Custom type conversions
     attribute Promise promiseAttribute;
     // DOM Node types
     attribute Document documentAttribute;
     attribute DocumentFragment documentFragmentAttribute;
     attribute DocumentType documentTypeAttribute;
     attribute Element elementAttribute;
     attribute Entity entityAttribute;
     attribute Node nodeAttribute;
     attribute ShadowRoot shadowRootAttribute;
     // Typed arrays
@@ skipping 15 matching lines @@
     attribute DOMString? nullableStringAttribute;
     attribute long? nullableLongAttribute;
     // Enumerations
     attribute TestEnum testEnumAttribute;
     // Static attributes
     static attribute DOMString staticStringAttribute;
     static attribute long staticLongAttribute;
     // Constructors
     // attribute attribute TestSubObjConstructor TestSubObj;
     attribute TestObjectAConstructor testObjectAConstructorAttribute;
-    // Special types
+    // Exceptional type
     attribute EventHandler eventHandlerAttribute;
 
     // Extended attributes
     [ActivityLogging=ForAllWorlds] attribute long activityLoggingAccessForAllWorldsLongAttribute;
     [ActivityLogging=GetterForAllWorlds] attribute long activityLoggingGetterForAllWorldsLongAttribute;
     [ActivityLogging=SetterForAllWorlds] attribute long activityLoggingSetterForAllWorldsLongAttribute;
     [CachedAttribute=isValueDirty] attribute any cachedAttributeAnyAttribute;
     [CallWith=ExecutionContext] attribute any callWithExecutionContextAnyAttribute;
     [CheckSecurity=Node] readonly attribute Document checkSecurityForNodeReadonlyDocumentAttribute;  // All uses are read only
     [Conditional=Condition] attribute long conditionalLongAttribute;
@@ skipping 22 matching lines @@
     [PerContextEnabled=FeatureName] attribute long perContextEnabledLongAttribute;
     [PerWorldBindings] attribute long perWorldBindingsLongAttribute;
     [PerWorldBindings] readonly attribute long perWorldBindingsReadonlyLongAttribute;  // Separate read only attribute to check attribute configuration
     [ActivityLogging=ForAllWorlds, PerWorldBindings] attribute long activityLoggingAccessPerWorldBindingsLongAttribute;
     [ActivityLogging=ForIsolatedWorlds, PerWorldBindings] attribute long activityLoggingAccessForIsolatedWorldsPerWorldBindingsLongAttribute;
     [ActivityLogging=GetterForAllWorlds, PerWorldBindings] attribute long activityLoggingGetterPerWorldBindingsLongAttribute;
     [ActivityLogging=GetterForIsolatedWorlds, PerWorldBindings] attribute long activityLoggingGetterForIsolatedWorldsPerWorldBindingsLongAttribute;
     [RaisesException] attribute long raisesExceptionLongAttribute;
     [Reflect] attribute TestInterface reflectTestInterfaceAttribute;
     [Reflect=reflectedNameAttribute] attribute TestInterface reflectReflectedNameAttributeTestAttribute;
-    // [Reflect] special types: special getters, special setters, or range
-    // checking for unsigned
+    // [Reflect] exceptional types: exceptional getters, exceptional setters,
+    // or range checking for unsigned
     [Reflect] attribute boolean reflectBooleanAttribute;
     [Reflect] attribute long reflectLongAttribute;
     [Reflect] attribute unsigned short reflectUnsignedShortAttribute;
     [Reflect] attribute unsigned long reflectUnsignedLongAttribute;
-    // [Reflect] special names
+    // [Reflect] exceptional names
     [Reflect] attribute DOMString id;
     [Reflect] attribute DOMString name;
     [Reflect] attribute DOMString class;
     [Reflect=id] attribute DOMString reflectedId;
     [Reflect=name] attribute DOMString reflectedName;
     [Reflect=class] attribute DOMString reflectedClass;
     [Replaceable] readonly attribute long replaceableReadonlyLongAttribute;
     [RuntimeEnabled=FeatureName] attribute long runtimeEnabledLongAttribute;
     [Conditional=Condition, RuntimeEnabled=FeatureName] attribute long conditionalRuntimeEnabledLongAttribute;
     [SetterCallWith=ActiveWindow&FirstWindow] attribute DOMString setterCallWithActiveWindowAndFirstWindowStringAttribute;
@@ skipping 39 matching lines @@
     void voidMethodLongLongArg(long long longLongArg);
     void voidMethodOctetArg(octet octetArg);
     void voidMethodShortArg(short shortArg);
     void voidMethodUnsignedLongArg(unsigned long unsignedLongArg);
     void voidMethodUnsignedLongLongArg(unsigned long long unsignedLongLongArg);
     void voidMethodUnsignedShortArg(unsigned short unsignedShortArg);
     // Interface types
     TestInterfaceEmpty testInterfaceEmptyMethod();
     void voidMethodTestInterfaceEmptyArg(TestInterfaceEmpty testInterfaceEmptyArg);
     void voidMethodLongArgTestInterfaceEmptyArg(long longArg, TestInterfaceEmpty testInterfaceEmptyArg);
-    // Special type conversions
+    // Custom type conversions
     CompareHow compareHowMethod();
     MediaQueryListListener mediaQueryListListenerMethod();
     any anyMethod();
     void voidMethodMediaQueryListListenerArg(MediaQueryListListener mediaQueryListListenerArg);
     void voidMethodCompareHowArg(CompareHow compareHowArg);
     void voidMethodAnyArg(any anyArg);
     // DOM node types
     void voidMethodAttrArg(Attr attrArg);
     void voidMethodDocumentArg(Document documentArg);
     void voidMethodDocumentTypeArg(DocumentType documentTypeArg);
@@ skipping 23 matching lines @@
     sequence<TestInterfaceEmpty> sequenceTestInterfaceEmptyMethod();
     void voidMethodSequenceLongArg(sequence<long> sequenceLongArg);
     void voidMethodSequenceStringArg(sequence<DOMString> sequenceStringArg);
     void voidMethodSequenceTestInterfaceEmptyArg(sequence<TestInterfaceEmpty> sequenceTestInterfaceEmptyArg);
     // Nullable types
     // Currently only used on interface type arguments
     void voidMethodNullableStringArg(TestInterfaceEmpty? nullableTestInterfaceEmptyArg);
     // Enumerations
     TestEnum testEnumMethod();
     void voidMethodTestEnumArg(TestEnum testEnumTypeArg);
-    // Special types
+    // Exceptional types
     Dictionary dictionaryMethod();
     NodeFilter nodeFilterMethod();
     Promise promiseMethod();
     SerializedScriptValue serializedScriptValueMethod();
     XPathNSResolver xPathNSResolverMethod();
     void voidMethodDictionaryArg(Dictionary dictionaryArg);
     void voidMethodNodeFilterArg(NodeFilter nodeFilterArg);
     void voidMethodPromiseArg(Promise promiseArg);
     void voidMethodSerializedScriptValueArg(SerializedScriptValue serializedScriptValueArg);
     void voidMethodXPathNSResolverArg(XPathNSResolver xPathNSResolverArg);
 
     // Arguments
     void voidMethodStringArgLongArg(DOMString stringArg, long longArg);
     // Optional arguments
     void voidMethodOptionalStringArg(optional DOMString optionalStringArg);
     void voidMethodOptionalTestInterfaceEmptyArg(optional TestInterfaceEmpty optionalTestInterfaceEmptyArg);
     void voidMethodOptionalLongArg(optional long optionalLongArg);
     DOMString stringMethodOptionalLongArg(optional long optionalLongArg);
     TestInterfaceEmpty testInterfaceEmptyMethodOptionalLongArg(optional long optionalLongArg);
     long longMethodOptionalLongArg(optional long optionalLongArg);
-    // Optional arguments: special case
-    void voidMethodOptionalDictionaryArg(optional Dictionary optionalDictionaryArg);
-
     void voidMethodLongArgOptionalLongArg(long longArg, optional long optionalLongArg);
     void voidMethodLongArgOptionalLongArgOptionalLongArg(long longArg, optional long optionalLongArg1, optional long optionalLongArg2);
     void voidMethodLongArgOptionalTestInterfaceEmptyArg(long longArg, optional TestInterfaceEmpty optionalTestInterfaceEmpty);
     void voidMethodTestInterfaceEmptyArgOptionalLongArg(TestInterfaceEmpty optionalTestInterfaceEmpty, optional long longArg);
+    // Optional arguments: exceptional case
+    void voidMethodOptionalDictionaryArg(optional Dictionary optionalDictionaryArg);
+
     // Variadic operations
     void voidMethodVariadicStringArg(DOMString... variadicStringArgs);
     void voidMethodStringArgVariadicStringArg(DOMString stringArg, DOMString... variadicStringArgs);
     void voidMethodVariadicTestInterfaceEmptyArg(TestInterfaceEmpty... variadicTestInterfaceEmptyArgs);
     void voidMethodTestInterfaceEmptyArgVariadicTestInterfaceEmptyArg(TestInterfaceEmpty testInterfaceEmptyArg, TestInterfaceEmpty... variadicTestInterfaceEmptyArgs);
 
     // Overloaded methods
     void overloadedMethodA(long longArg);
     void overloadedMethodA(long longArg1, long longArg2);
     void overloadedMethodB(long longArg);
     void overloadedMethodB(long longArg1, optional long longArg2);
     void overloadedMethodC(long longArg);
     void overloadedMethodC(long longArg, long... longArgs);
     void overloadedMethodD(long longArg);
     void overloadedMethodD(TestInterfaceEmpty testInterfaceEmptyArg);
     void overloadedMethodE(long longArg);
     void overloadedMethodE(long[] longArrayArg);
 
     static void overloadedStaticMethod(long longArg);
     static void overloadedStaticMethod(long longArg1, long longArg2);
 
+    // Exceptional methods for EventListener
+    void addEventListener(DOMString type,
+                          EventListener listener,
+                          optional boolean useCapture);
+    void removeEventListener(DOMString type,
+                             EventListener listener,
+                             optional boolean useCapture);
+
     // Extended attributes for arguments
     // [Clamp]
     void voidMethodClampUnsignedShortArg([Clamp] unsigned short clampUnsignedShortArg);
     void voidMethodClampUnsignedLongArg([Clamp] unsigned long clampUnsignedLongArg);
     // [Default]
     void voidMethodDefaultUndefinedTestInterfaceEmptyArg([Default=Undefined] optional TestInterfaceEmpty defaultUndefinedTestInterfaceEmptyArg);
     void voidMethodDefaultUndefinedLongArg([Default=Undefined] optional long defaultUndefinedLongArg);
     void voidMethodDefaultUndefinedStringArg([Default=Undefined] optional DOMString defaultUndefinedStringArg);
     void voidMethodDefaultNullStringStringArg([Default=NullString] optional DOMString defaultNullStringStringArg);
     // [EnforceRange]
@@ skipping 33 matching lines @@
     [RaisesException] void raisesExceptionVoidMethodOptionalLongArg(optional long optionalLongArg);
     [ReadOnly] void readOnlyVoidMethod();
     [NotEnumerable, ReadOnly] void notEnumerableReadOnlyVoidMethod();
     [RuntimeEnabled=FeatureName] void runtimeEnabledVoidMethod();
     [PerWorldBindings, RuntimeEnabled=FeatureName] void perWorldBindingsRuntimeEnabledVoidMethod();
     [StrictTypeChecking] void strictTypeCheckingVoidMethodTestInterfaceEmptyArg(TestInterfaceEmpty testInterfaceEmptyArg);
     [TreatReturnedNullStringAs=Null] DOMString treatReturnedNullStringAsNullStringMethod();
     [TreatReturnedNullStringAs=Undefined] DOMString treatReturnedNullStringAsUndefinedStringMethod();
     [Unforgeable] void unforgeableVoidMethod();
 };