feat: Search $all strings starting with given strings

Author: Eduard Bosch Bertran

src/ParseQuery.js

@@ -229,6 +229,13 @@ export default class ParseQuery {
     return this;
   }
 
+  /**
+   * Converts string for regular expression at the beginning
+   */
+  _regexStartWith(string: string): String {
+    return '^' + quote(string);
+  }
+
   /**
    * Returns a JSON representation of this query.
    * @method toJSON
@@ -682,6 +689,27 @@ export default class ParseQuery {
     return this._addCondition(key, '$all', values);
   }
 
+  /**
+   * Adds a constraint to the query that requires a particular key's value to
+   * contain each one of the provided list of values starting with given strings.
+   * @method containsAllStartingWith
+   * @param {String} key The key to check.  This key's value must be an array.
+   * @param {Array<String>} values The string values that will match as starting string.
+   * @return {Parse.Query} Returns the query, so you can chain this call.
+   */
+  containsAllStartingWith(key: string, values: Array<string>): ParseQuery {
+    var _this = this;
+    if (!Array.isArray(values)) {
+      values = [values];
+    }
+
+    values = values.map(function (value) {
+      return {"$regex": _this._regexStartWith(value)};
+    });
+
+    return this.containsAll(key, values);
+  }
+
   /**
    * Adds a constraint for finding objects that contain the given key.
    * @method exists
@@ -826,7 +854,7 @@ export default class ParseQuery {
     if (typeof value !== 'string') {
       throw new Error('The value being searched for must be a string.');
     }
-    return this._addCondition(key, '$regex', '^' + quote(value));
+    return this._addCondition(key, '$regex', this._regexStartWith(value));
   }
 
   /**

src/__tests__/ParseQuery-test.js

@@ -264,6 +264,33 @@ describe('ParseQuery', () => {
     });
   });
 
+  it('can generate contains-all-starting-with queries', () => {
+    var q = new ParseQuery('Item');
+    q.containsAllStartingWith('tags', ['ho', 'out']);
+    expect(q.toJSON()).toEqual({
+      where: {
+        tags: {
+          $all: [
+            {$regex: '^\\Qho\\E'},
+            {$regex: '^\\Qout\\E'}
+          ]
+        }
+      }
+    });
+
+    q.containsAllStartingWith('tags', ['sal', 'ne']);
+    expect(q.toJSON()).toEqual({
+      where: {
+        tags: {
+          $all: [
+            {$regex: '^\\Qsal\\E'},
+            {$regex: '^\\Qne\\E'}
+          ]
+        }
+      }
+    });
+  });
+
   it('can generate exists queries', () => {
     var q = new ParseQuery('Item');
     q.exists('name');