feat(content): Optional search parameter (#733)

* docs: updated FR & EN docs with optional search

* feat: optional search

* fix: lint

* fix: empty or falsey values instead of boolean false

Author: Billybobbonnet

docs/content/en/fetching.md

@@ -148,11 +148,15 @@ Performs a full-text search on a field. `value` is optional, in this case `field
 
 The fields you want to search on must be defined in options in order to be indexed, see [configuration](/configuration#fulltextsearchfields).
 
+Using an empty string as parameter will skip the search.
+
 ```js
 // Search on field title
 const articles = await this.$content('articles').search('title', 'welcome').fetch()
 // Search on all pre-defined fields
 const articles = await this.$content('articles').search('welcome').fetch()
+// Search will be skipped if the search string is empty
+const articles = await this.$content('articles').search('').fetch()
 ```
 
 <alert type="info">

docs/content/fr/fetching.md

@@ -141,11 +141,15 @@ Effectue une recherche plein texte sur un champ. Le paramètre `value` est optio
 
 Le champ sur lequel vous voulez effectuer la recherche doit être défini dans les options afin d'être indexé, voir [configuration](/fr/configuration#fulltextsearchfields).
 
+Utiliser une chaîne de caractères vide comme paramètre `value` n'exécutera pas la recherche.
+
 ```js
 // Search on field title
 const articles = await this.$content('articles').search('titre', 'bienvenue').fetch()
 // Search on all pre-defined fields
 const articles = await this.$content('articles').search('bievenue').fetch()
+// Search will be skipped if the search string is empty
+const articles = await this.$content('articles').search('').fetch()
 ```
 
 ### surround(slug, options)

packages/content/lib/query-builder.js

@@ -81,6 +81,9 @@ class QueryBuilder {
    * @returns {QueryBuilder} Returns current instance to be chained
    */
   search (query, value) {
+    // Passing an empty or falsey value as query will avoid triggering a search to allow optional chaining
+    if (!query?.length) { return this }
+
     let $fts
 
     if (typeof query === 'object') {