[bindings] Implement an ExperimentEnabled IDL extended attribute.

third_party/WebKit/Source/bindings/scripts/v8_utilities.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 362 matching lines @@
         return lambda suffix: extended_attributes['MeasureAs']
     if 'Measure' in extended_attributes:
         includes.add('core/frame/UseCounter.h')
         measure_as_name = capitalize(definition_or_member.name)
         if interface is not None:
             measure_as_name = '%s_%s' % (capitalize(interface.name), measure_as_name)
         return lambda suffix: 'V8%s_%s' % (measure_as_name, suffix)
     return None
 
 
+def is_api_experiment_enabled(interface):
+    return 'APIExperimentEnabled' in interface.extended_attributes
+
+
+def api_experiment_name(interface):
+    return interface.extended_attributes['APIExperimentEnabled'] if is_api_experiment_enabled(interface) else None
+
+
 # [RuntimeEnabled]
 def runtime_enabled_function_name(definition_or_member):
+    """Returns a conditional string which defines if a given
+    method/attribute is enabled at runtime. This is based on the RuntimeEnabled
+    and the API Experiment Enabled conditionals.
+    """
+    extended_attributes = definition_or_member.extended_attributes
+    runtime_conditional = runtime_enabled_conditional(extended_attributes)
+    experiment_conditional = api_experiment_enabled_conditional(extended_attributes)
+
+    if runtime_conditional is not None and experiment_conditional is not None:
+        return ('%s && %s' % (runtime_conditional, experiment_conditional))
+    return runtime_conditional if runtime_conditional else experiment_conditional
+
+
+def runtime_enabled_conditional(extended_attributes):
     """Returns the name of the RuntimeEnabledFeatures function.
 
     The returned function checks if a method/attribute is enabled.
     Given extended attribute RuntimeEnabled=FeatureName, return:
         RuntimeEnabledFeatures::{featureName}Enabled
     """
-    extended_attributes = definition_or_member.extended_attributes
     if 'RuntimeEnabled' not in extended_attributes:
         return None
     feature_name = extended_attributes['RuntimeEnabled']
-    return 'RuntimeEnabledFeatures::%sEnabled' % uncapitalize(feature_name)
+    runtime_function = 'RuntimeEnabledFeatures::%sEnabled()' % uncapitalize(feature_name)
+    return runtime_function
+
+
+# [APIExperimentEnabled]
+def api_experiment_enabled_conditional(extended_attributes):
+    """Returns the name of the API Experiment Enabled function.
+
+    The returned function checks if a method/attribute is enabled.
+    Given extended attribute APIExperimentEnabled=ExperimentName, return:
+        Experiments::isApiEnabled(currentExecutionContext(isolate),
+            "{ExperimentName}")
+    """
+    if 'APIExperimentEnabled' not in extended_attributes:
+        return None
+    return 'Experiments::isApiEnabled(currentExecutionContext(isolate), "%s")' % extended_attributes['APIExperimentEnabled']
 
 
 # [Unforgeable]
 def is_unforgeable(interface, member):
     return (('Unforgeable' in interface.extended_attributes or
              'Unforgeable' in member.extended_attributes) and
             not member.is_static)
 
 
 # [LegacyInterfaceTypeChecking]
@@ skipping 172 matching lines @@
     except StopIteration:
         return None
 
 
 IdlInterface.indexed_property_getter = property(indexed_property_getter)
 IdlInterface.indexed_property_setter = property(indexed_property_setter)
 IdlInterface.indexed_property_deleter = property(indexed_property_deleter)
 IdlInterface.named_property_getter = property(named_property_getter)
 IdlInterface.named_property_setter = property(named_property_setter)
 IdlInterface.named_property_deleter = property(named_property_deleter)