Changes between Version 130 and Version 131 of WebKitIDL

Timestamp:

Jul 8, 2013, 9:57:30 AM (11 years ago)

Author:

stavila@adobe.com

Comment:

Added TreatReturnedNullObjectAs attribute.

WebKitIDL

@@ -10 +10 @@
  - [#TreatNullAs TreatNullAs(a,p), TreatUndefinedAs(a,p)][[br]]
  - [#TreatReturnedNullStringAs TreatReturnedNullStringAs(m,a)][[br]]
+ - [#TreatReturnedNullObjectAs TreatReturnedNullObjectAs(m)][[br]]
  - [#Default Default(p)][[br]]
  - [#Clamp Clamp(a,p)][[br]]
@@ -273 +274 @@
 Note that what should be specified on `[TreatReturnedNullStringAs=...]` depends on the spec of each attribute or method.
 
+== `[TreatReturnedNullObjectAs]`(m) == #TreatReturnedNullObjectAs
+
+Summary: `[TreatReturnedNullObjectAs]` controls the behavior when a WebKit null object is returned from the WebCore implementation.
+
+Usage: The possible usage is `[TreatReturnedNullObjectAs=Undefined]`.
+It can be specified on methods that return an object:
+{{{
+    [TreatReturnedNullObjectAs=Undefined] Object func();
+}}}
+
+ * `[TreatReturnedNullObjectAs=Undefined]` indicates that if the returned object is null, the returned value is treated as a JavaScript undefined.
+
+Without `[TreatReturnedNullObjectAs=Undefined]`, if the returned object is null, then the returned value is treated as a JavaScript null.
+
 == `[Default]`(p) == #Default