Changes between Version 119 and Version 120 of WebKitIDL

Timestamp:

Jun 4, 2013 8:26:51 AM (11 years ago)

Author:

Christophe Dumez

Comment:

Add documentation for [GlobalContext] introduced in r151169

WebKitIDL

@@ -54 +54 @@
  - [#ImplementationNamespace ImplementationNamespace(i)][[br]]
  - [#SkipVTableValidation SkipVTableValidation(i), ImplementationLacksVTable(i),][[br]]
- - [#NoInterfaceObject NoInterfaceObject(i)][[br]]
+ - [#NoInterfaceObject NoInterfaceObject(i), GlobalContext(i)][[br]]
  - [#EnabledAtRuntime EnabledAtRuntime(i)][[br]]
 
@@ -1435 +1435 @@
 }}}
 
-== `[NoInterfaceObject]`(i) == #NoInterfaceObject
+== `[NoInterfaceObject]`(i), `[GlobalContext]`(i) == #NoInterfaceObject
 
 Standard: [http://dev.w3.org/2006/webapi/WebIDL/#NoInterfaceObject The spec of NoInterfaceObject]
@@ -1444 +1444 @@
 * is a callback interface that has constants declared on it, or
 * is a non-callback interface that is not declared with the `[NoInterfaceObject]` extended attribute,
-a corresponding property is added on the global Window object by the bindings generator.
-
-Usage: `[NoInterfaceObject]` can be specified on interfaces.
+a corresponding property is automatically added on the ECMAScript global object by the bindings generator.
+
+The `[GlobalContext=WindowOnly|WorkerOnly|WindowAndWorker]` is a WebKit-specific extended attribute that may only be used on interfaces that do not have the `[NoInterfaceObject]` attribute. Three values are allowed for this attribute:
+* `WindowOnly`: A corresponding attribute (global constructor) will be automatically added on the `Window` interface (default if the extended attribute is omitted).
+* `WorkerOnly`: A corresponding attribute (global constructor) will be automatically added on the `WorkerContext` interface.
+* `WindowAndWorker`: A corresponding attribute (global constructor) will be automatically added on both the `Window` and the `WorkerContext` interfaces.
+
+Usage: `[NoInterfaceObject]` and `[GlobalContext]` can be specified on interfaces, but not at the same time.
 
 {{{
@@ -1452 +1457 @@
         NoInterfaceObject
     ] interface XXX {
+        ...
+    };
+
+    // A constructor property will be generated on the global WorkerContext object
+    // but not the Window object. 
+    [
+        GlobalContext=WorkerOnly
+    ] interface YYY {
         ...
     };