Merge c94d879 into 2a9c84e

README.md

@@ -118,6 +118,11 @@ Performs a search for `query` with the provided `options`.
 		<td valign="top">boolean</td>
 		<td valign="top">If <code>true</code>, nested fields will be available for search and sort using dot-notation to reference them (e.g. <code>nested.property</code>)<br><em>Warning: can reduce performance</em></td>
 	</tr>
+	<tr>
+		<td valign="top"><code>respect_word_boundaries</code></td>
+		<td valign="top">boolean</td>
+		<td valign="top">If <code>true</code>, matches only at start of word boundaries (e.g. the beginning of words, instead of matching the middle of words)</td>
+	</tr>
 </table>
 
 ## CLI

lib/sifter.js

@@ -45,7 +45,7 @@
 	 * @param {string} query
 	 * @returns {array}
 	 */
-	Sifter.prototype.tokenize = function(query) {
+	Sifter.prototype.tokenize = function(query, respect_word_boundaries) {
 		query = trim(String(query || '').toLowerCase());
 		if (!query || !query.length) return [];
 
@@ -62,6 +62,7 @@
 					}
 				}
 			}
+			if (respect_word_boundaries) regex = "\\b"+regex
 			tokens.push({
 				string : words[i],
 				regex  : new RegExp(regex, 'i')
@@ -318,7 +319,7 @@
 		return {
 			options : options,
 			query   : String(query || '').toLowerCase(),
-			tokens  : this.tokenize(query),
+			tokens  : this.tokenize(query, options.respect_word_boundaries),
 			total   : 0,
 			items   : []
 		};

test/api.js

@@ -185,6 +185,27 @@ describe('Sifter', function() {
 			assert.equal(result.items[0].id, 0);
 		});
 
+		it('should allow word boundaries to be respected', function() {
+			var sifter = new Sifter([
+				{name: 'John Smith'},
+				{name: 'Jane Doe'},
+			]);
+			var result = sifter.search('mith', {fields: 'name'});
+			assert.equal(result.items.length, 1);
+
+			var result = sifter.search('mith', {fields: 'name', respect_word_boundaries: true});
+			assert.equal(result.items.length, 0);
+
+			var result = sifter.search('Smi', {fields: 'name', respect_word_boundaries: true});
+			assert.equal(result.items.length, 1);
+
+			var result = sifter.search('John Sm', {fields: 'name', respect_word_boundaries: true});
+			assert.equal(result.items.length, 1);
+
+			var result = sifter.search('ohn Smith', {fields: 'name', respect_word_boundaries: true, conjunction: 'and'});
+			assert.equal(result.items.length, 0);
+		});
+
 		describe('sorting', function() {
 			it('should respect "sort_empty" option when query absent', function() {
 				var sifter = new Sifter([