ne( )

Refines a search to match documents whose specified field value does not equal the specified value.

Description

The ne() filter function refines a WixSearchBuilder to only match documents where the value of the specified field does not equal the specified value.

ne() only matches values of the same type. For example, a number value stored as a String type is considered not equal to the same number stored as a Number type.

Matching strings with ne() is case sensitive, so "text" is not equal to "Text".

If other filters were previously used in the same WixSearchBuilder instance, ne() is applied using an and condition with previously set filters.

Syntax

function ne(field: string, value: *): WixSearchBuilder

ne Parameters

NAME

TYPE

DESCRIPTION

field

string

The field whose value will be compared with value.

value

The value to match against.

Returns

A WixSearchBuilder object representing the refined search.

Return Type:

WixSearchBuilder

Was this helpful?

Add a not equals filter to a search

This example demonstrates how to exclude a forum category from a search for forum content]

Copy Code

1let newSearch = search
2  .documentType("Forum/Content")
3  .ne("categoryId", "5df7504fa9a9b30017fc1053");

Create a search, add a not equals filter, and run it

This example demonstrates how to exclude a product with a specific SKU from a search for store products

Copy Code

1import wixSearch from 'wix-search';
2
3// ...
4
5wixSearch.search()
6  .documentType("Stores/Products")
7  .ne("sku", "SHO-11-BLA")
8  .find()
9  .then( (results) => {
10    if(results.documents.length > 0) {
11      let documents = results.documents;
12    } else {
13      console.log("No matching results");
14    }
15  })
16  .catch( (error) => {
17    console.log(error);
18  });
19
20