Add some documentation

Author: aestuans

site/source/docs/api_reference/bind.h.rst

@@ -641,6 +641,41 @@ Classes
       :param typename... Policies: |policies-argument|
       :returns: |class_-function-returns|
 
+   .. cpp:function:: const class_& iterable() const
+
+      .. code-block:: cpp
+
+         // prototype
+         template<typename ElementType>
+         EMSCRIPTEN_ALWAYS_INLINE const class_& iterable(const char* sizeMethodName, const char* getMethodName) const
+
+      Makes a bound class iterable in JavaScript by installing ``Symbol.iterator``.
+      This enables use with ``for...of`` loops, ``Array.from()``, and spread syntax.
+
+      :tparam ElementType: The type of elements yielded by the iterator. Used for
+         TypeScript definition generation.
+
+      :param sizeMethodName: Name of the bound method that returns the number of elements.
+         Must return ``size_t``.
+
+      :param getMethodName: Name of the bound method that retrieves an element by index.
+         Must accept a ``size_t`` index and return ``ElementType``.
+
+      :returns: |class_-function-returns|
+
+      .. code-block:: cpp
+
+         class_<MyContainer>("MyContainer")
+            .function("size", &MyContainer::size)
+            .function("get", &MyContainer::get)
+            .iterable<int>("size", "get");
+
+      .. code-block:: javascript
+
+         const container = new Module.MyContainer();
+         for (const item of container) { /* ... */ }
+         const arr = Array.from(container);
+
 
    .. cpp:function:: const class_& property() const
 

site/source/docs/porting/connecting_cpp_and_javascript/embind.rst

@@ -1157,9 +1157,12 @@ The following JavaScript can be used to interact with the above C++.
     // push value into vector
     retVector.push_back(12);
 
-    // retrieve value from the vector
-    for (var i = 0; i < retVector.size(); i++) {
-        console.log("Vector Value: ", retVector.get(i));
+    // retrieve a value from the vector
+    console.log("Vector Value at index 0: ", retVector.get(0));
+
+    // iterate over vector
+    for (var value of retVector) {
+        console.log("Vector Value: ", value);
     }
 
     // expand vector size