From f07323715f2fa395159fb705e468aadf24202208 Mon Sep 17 00:00:00 2001
From: Ilya Gorbunov <ilya.gorbunov@jetbrains.com>
Date: Tue, 20 Dec 2016 23:37:45 +0300
Subject: [PATCH] Provide some docs for dynamic.iterator()

---
 js/js.libraries/src/core/dynamic.kt | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/js/js.libraries/src/core/dynamic.kt b/js/js.libraries/src/core/dynamic.kt
index b1b368c8cee..9afdd6eafcc 100644
--- a/js/js.libraries/src/core/dynamic.kt
+++ b/js/js.libraries/src/core/dynamic.kt
@@ -30,7 +30,12 @@ public inline fun <T> Any?.unsafeCast(): @kotlin.internal.NoInfer T = this.asDyn
 @JsName("unsafeCastDynamic")
 public inline fun <T> dynamic.unsafeCast(): @kotlin.internal.NoInfer T = this
 
-// TODO add the support ES6 iterators
+/**
+ * Allows to iterate this `dynamic` object in the following cases:
+ * - when it has an `iterator` function,
+ * - when it is an array
+ * - when it is an instance of [kotlin.collections.Iterable]
+ */
 @kotlin.internal.DynamicExtension
 public operator fun dynamic.iterator(): Iterator<dynamic> {
     val r: Any? = this