Add the new fullTextSearch method with the associated tests.

Author: vinz51

src/ParseQuery.js

@@ -1013,6 +1013,37 @@ export default class ParseQuery {
     return this._addCondition(key, '$geoWithin', { '$polygon': points });
   }
 
+  /**
+   * Method to find by full text.
+   * The key and the search fields are required the others are optionals.
+   * @method fullTextSearch
+   * @param {String} key The key to structure the where query
+   * @param {String} search The string to search
+   * @param {String} language Determine the list of stop words
+   * @param {Boolean} caseSensitive Dis/en-able the case sensitive search
+   * @param {Boolean} diacriticSensitive Dis/en-able diacritic sensitive search
+   * @return {Parse.Query} Returns the query, so you can chain this call.
+   */
+  fullTextSearch(key: string, search: string, language: string, caseSensitive: boolean, diacriticSensitive: boolean): ParseQuery {
+    if (typeof key === 'undefined' || !key) {
+      throw new Error('A key is required.');
+    }
+    if (typeof search === 'undefined' || !search) {
+      throw new Error('You have to add one string to search.');
+    }
+    var options = { '$term': search };
+    if (typeof language !== "undefined" || language !== null) {
+      options['$language'] = language;
+    }
+    if (typeof caseSensitive !== "undefined" || caseSensitive !== null) {
+      options['$caseSensitive'] = caseSensitive;
+    }
+    if (typeof diacriticSensitive !== "undefined" || diacriticSensitive !== null) {
+      options['$diacriticSensitive'] = diacriticSensitive;
+    }
+    return this._addCondition(key, '$text', { '$search': options });
+  }
+
   /** Query Orderings **/
 
   /**
@@ -1091,6 +1122,17 @@ export default class ParseQuery {
     return this;
   }
 
+  /**
+   * Method to sort the full text search by text score
+   * @method sortByTextScore
+   * @return {Parse.Query} Returns the query, so you can chain this call.
+   */
+  sortByTextScore() {
+    this.ascending('$score');
+    this.select(['$score']);
+    return this;
+  }
+
   /** Query Options **/
 
   /**

src/__tests__/ParseQuery-test.js

@@ -1584,4 +1584,67 @@ describe('ParseQuery', () => {
     });
 
   });
+
+  it('full text search with one parameter', () => {
+    let query = new ParseQuery('Item');
+
+    query.fullTextSearch('size', 'small');
+
+    expect(query.toJSON()).toEqual({
+      where: {
+        size: {
+          $text: {
+            $search: {
+              $term: "small"
+            }
+          }
+        }
+      }
+    });
+  });
+
+  it('full text search with all parameters', () => {
+    let query = new ParseQuery('Item');
+
+    query.fullTextSearch('size', 'medium', 'en', false, true);
+
+    expect(query.toJSON()).toEqual({
+      where: {
+        size: {
+          $text: {
+            $search: {
+              $term: "medium",
+              $language: "en",
+              $caseSensitive: false,
+              $diacriticSensitive: true
+            }
+          }
+        }
+      }
+    });
+
+  });
+  
+  it('add the score for the full text search', () => {
+    let query = new ParseQuery('Item');
+    
+    query.fullTextSearch('size', 'medium', 'fr');
+    query.sortByTextScore();
+    
+    expect(query.toJSON()).toEqual({
+      where: {
+        size: {
+          $text: {
+            $search: {
+              $term: "medium",
+              $language: "fr"
+            }
+          }
+        }
+      },
+      keys : "$score",
+      order : "$score"
+    });
+    
+  });
 });