Changes between Version 117 and Version 118 of WebKitIDL

Timestamp:

May 17, 2013, 2:54:12 PM (12 years ago)

Author:

Christophe Dumez

Comment:

Add documentation for [EnabledAtRuntime] introduced in r150276

WebKitIDL

@@ -55 +55 @@
  - [#SkipVTableValidation SkipVTableValidation(i), ImplementationLacksVTable(i),][[br]]
  - [#NoInterfaceObject NoInterfaceObject(i)][[br]]
-
+ - [#EnabledAtRuntime EnabledAtRuntime(i)][[br]]
 
 = Overview = #Overview
@@ -1439 +1439 @@
 Standard: [http://dev.w3.org/2006/webapi/WebIDL/#NoInterfaceObject The spec of NoInterfaceObject]
 
-Summary: If the `[NoInterfaceObject]` extended attribute appears on an interface, it indicates that an interface object will not exist for the interface in the ECMAScript binding.
+Summary: If the `[NoInterfaceObject]` extended attribute is specified on an interface, it indicates that an interface object will not exist for the interface in the ECMAScript binding.
 
 Note that for every interface that:
@@ -1455 +1455 @@
     };
 }}}
+
+== `[EnabledAtRuntime]`(i) == #EnabledAtRuntime
+
+Standard: this is a non-standard attribute
+
+Summary: If the `[EnabledAtRuntime]` extended attribute is specified on non-callback interface that is not declared with the `[NoInterfaceObject]` extended attribute, it indicates that the corresponding attribute(s) generated on the global Window object can be enabled / disabled at runtime.
+
+The `RuntimeEnabledFeatures` class will be used to determine if the global constructor should be enabled, at runtime. By default, the name of the interface is used as feature name but it is possible to specify the feature name explicitly as well via `[EnabledAtRuntime=FeatureName]`.
+
+Usage: `[EnabledAtRuntime]` can be specified on interfaces.
+
+{{{
+    // window.XXX will only be enabled if RuntimeEnabledFeatures::xXXEnabled() returns true.
+    [
+        EnabledAtRuntime
+    ] interface XXX {
+        ...
+    };
+
+    // window.YYY will only be enabled if RuntimeEnabledFeatures::featureNameEnabled() returns true.
+    [
+        EnabledAtRuntime=FeatureName
+    ] interface YYY {
+        ...
+    };
+}}}