Changes between Version 22 and Version 23 of WebKitIDL

Timestamp:

Feb 13, 2012 6:15:34 AM (12 years ago)

Author:

haraken@chromium.org

Comment:

--

WebKitIDL

@@ -20 +20 @@
 
 = IDL attributes =
+
+[http://foo.com/ `[`foo`]`]
 
 == Basic naming rules ==
@@ -126 +128 @@
 === * [CallWith](m,a) ===
 
+Summary: With [CallWith], a WebCore method is called with additional information.
+
+Usage: The possible usage is [CallWith=X1|X2|X3|...], where X1, X2, X3, ... is "ScriptExecutionContext", "ScriptState", "ScriptArguments" or "CallStack".
+"ScriptExecutionContext", "ScriptState" and "CallStack" can be specified on methods or attributes,
+but "ScriptArguments" can be specified on methods only:
+{{{
+    interface HTMLFoo {
+        attribute [CallWith=ScriptExecutionContext] DOMString str;
+        [CallWith=ScriptExecutionContext] void func1(in int a, in int b);
+        [CallWith=ScriptState] void func2(in int a, in int b);
+        [CallWith=ScriptArguments|CallStack] void func3(in int a, in int b);
+        [CallWith=CallStack|ScriptArguments] void func4(in int a, in int b);
+    }
+}}}
+
+In case of func1(...), HTMLFoo::func1(ScriptExecutionContext* context, int a, int b) is called.
+Thus, in HTMLFoo::func1(...) you can retrieve document or window through context.
+
+In case of func2(...), HTMLFoo::func2(ScriptState* state, int a, int b) is called.
+
+In case of func3(...), HTMLFoo::func3(ScriptArguments* arguments, ScriptCallStack* callstack, int a, int b) is called.
+
+In this way, the additional information is added at the head of normal arguments.
+The order of additional information is "ScriptExecutionContext", "ScriptState", "ScriptArguments", and then "CallStack",
+despite the order of [CallWith=X1|X2|X3|...]. Thus, in case of func4(...),
+HTMLFoo::func3(ScriptArguments* arguments, ScriptCallStack* callstack, int a, int b) is called.
+
 === * [CheckAccessToNode](m,a) ===
 
@@ -171 +200 @@
 === * [Deletable](a), [NotEnumerable](a), [V8ReadOnly](a) ===
 
- * [http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf The spec of ''[[''Writable'']]'', [[Enumerable]] and [[Configurable]] (8.6.1)]
+ * [http://www.ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf The spec of [[Writable]], [[Enumerable]] and [[Configurable]] (8.6.1)]
 
 Summary: They control Writability, Enumerability and Configurability of attributes.