Changes between Version 128 and Version 129 of WebKitIDL

Timestamp:

Jun 28, 2013 7:52:19 AM (11 years ago)

Author:

Christophe Dumez

Comment:

Update documentation for [GlobalContext] after r152100

WebKitIDL

@@ -1407 +1407 @@
 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.
+`[GlobalContext=*]` is a WebKit-specific extended attribute that may only be used on interfaces that do not have the `[NoInterfaceObject]` attribute. The following values are allowed for this attribute:
+* `DOMWindow`: A corresponding attribute (global constructor) will be automatically added on the `DOMWindow` interface (default if the extended attribute is omitted).
+* `WorkerGlobalScope`: A corresponding attribute (global constructor) will be automatically added on the `WorkerGlobalScope` interface.
+* `SharedWorkerGlobalScope`: A corresponding attribute (global constructor) will be automatically added on the `SharedWorkerGlobalScope` interface.
+* `DedicatedWorkerGlobalScope`: A corresponding attribute (global constructor) will be automatically added on the `DedicatedWorkerGlobalScope` interface.
+
+It is possible to have the global constructor generated on several interfaces by specifying several interface names and separating them with a '&', for e.g. `[GlobalContext=DOMWindow&WorkerGlobalScope]`.
 
 Usage: `[NoInterfaceObject]` and `[GlobalContext]` can be specified on interfaces, but not at the same time.
@@ -1421 +1424 @@
     };
 
-    // A constructor property will be generated on the global WorkerContext object
-    // but not the Window object. 
-    [
-        GlobalContext=WorkerOnly
+    // A 'YYY' constructor property will be generated on the global DedicatedWorkerGlobalScope object.
+    [
+        GlobalContext=DedicatedWorkerGlobalScope
     ] interface YYY {
+        ...
+    };
+
+    // A 'ZZZ' constructor property will be generated on both the global Window object and the global WorkerGlobalScope object.
+    [
+        GlobalContext=DOMWindow&WorkerGlobalScope
+    ] interface ZZZ {
         ...
     };