added function comment

cheeriojs · Jan 27, 2021 · 12f9177 · 12f9177
1 parent 2f065a9
commit 12f9177
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 1 deletion.
diff --git a/lib/api/traversing.js b/lib/api/traversing.js
@@ -12,6 +12,15 @@ var uniqueSort = require('htmlparser2').DomUtils.uniqueSort;
 var isTag = utils.isTag;
 var reSiblingSelector = /^\s*[~+]/;
 
+/**
+ * Matcher provides function, what finds elements based on function provided. It
+ * also houses filtering. What may provided later when function is called.
+ *
+ * @private
+ * @param {Function} fn - Function for collecting elements.
+ * @param {boolean} reverse - Is output in reverse order.
+ * @returns {Function} - Wrapped function.
+ */
 function _matcher(fn, reverse) {
   // customized Map, discards null elements
   function matchMap(elems, cb, arg) {

diff --git a/test/api/traversing.js b/test/api/traversing.js
@@ -556,10 +556,10 @@ describe('$(...)', function () {
 
       expect($parents).toHaveLength(5);
       expect($parents[0]).toBe($('#vegetables')[0]);
+      expect($parents[1]).toBe($('#fruits')[0]);
       expect($parents[2]).toBe($('#food')[0]);
       expect($parents[3]).toBe($('body')[0]);
       expect($parents[4]).toBe($('html')[0]);
-      expect($parents[1]).toBe($('#fruits')[0]);
     });
   });