docs: add doc for "tryInterval" test utility

diff --git a/test/javascript/lib/utils.js b/test/javascript/lib/utils.js
index 0f269834aa5f605a5f5cedd0eca12be601f74441..cb0e5aa2e4f657e3b716ab8694fe9044870c8ab3 100644 (file)
--- a/test/javascript/lib/utils.js
+++ b/test/javascript/lib/utils.js
@@ -1,5 +1,14 @@
 (function (global, $) {
 
+  /**
+  * Try to catch the `do` function every `interval` delay, until it succedes
+  * (does not throw an error) or a given `timout` time passed.
+  * If a `then` function is passed, it is called after `do` succeded.
+  * If a `catch` function is passed, it is called after each time `do` fails.
+  *
+  * @param  {object} opts
+  * @param  {object} opts
+  */
   global.tryInterval = function (opts) {
     var _opts = $.extend({}, opts);
     var totalTime = 0;