Changes between Version 68 and Version 69 of WebKitIDL

Timestamp:

Apr 11, 2012 11:30:26 PM (12 years ago)

Author:

arv@chromium.org

Comment:

Document the ArrayClass IDL attribute

WebKitIDL

@@ -56 +56 @@
  - [#CPPPureInterface CPPPureInterface(i)][[br]]
  - [#CustomReturn CustomReturn(p)][[br]]
+ - [#ArrayClass ArrayClass(i)][[br]]
  - [#OmitConstructor OmitConstructor, Immutable, MasqueradesAsUndefined, CustomGetOwnPropertySlot, ReplaceableConstructor, ExtendsDOMGlobalObject, IsIndex, V8DoNotCheckSignature, NumericIndexedGetter][[br]]
 
@@ -1678 +1679 @@
 Used by ObjC, GObject and CPP bindings only.
 
+== [ArrayClass](i) == #ArrayClass
+
+* [http://dev.w3.org/2006/webapi/WebIDL/#ArrayClass The spec of ArrayClass]
+
+Summary: Allows an interface to extend JavaScript arrays.
+
+Usage: [ArrayClass] can be specified on interfaces. An interface may not both have [ArrayClass] and extend another interface.
+
+The bindings for the interface will have the `[[Prototype]]` of the constructor prototype set to `Array.prototype` which means that the methods defined on JavaScript arrays work on the instances of this interface.
+
+{{{
+// IDL
+interface [
+    ArrayClass,
+    IndexedGetter
+] NodeList {
+    Node item(in unsigned long index);
+    readonly attribute unsigned long length;
+}
+
+// JS
+myNodeList instanceof Array  // true
+myNodeList.forEach(function(node) { console.log(node_; });
+}}}
+
 == [OmitConstructor], [Immutable], [MasqueradesAsUndefined], [CustomGetOwnPropertySlot], [ReplaceableConstructor], [ExtendsDOMGlobalObject], [IsIndex], [V8DoNotCheckSignature], [NumericIndexedGetter] == #OmitConstructor