> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Method name: ascending(field: Array<string>)

# Method package: wixSearch

# Method menu location: wixSearch --> WixSearchBuilder --> ascending

# Method Link: https://dev.wix.com/docs/velo/apis/wix-search/wix-search-builder/ascending.md

# Method Description:

Adds a sort to a search, sorting by the specified fields in ascending order.

The `ascending()` function refines a `WixSearchBuilder` to sort in ascending order of
 the specified fields. If you specify more than one field,
 `ascending()` sorts the results in ascending order by each field in the
 order they are listed.

 You can sort the following types:

 + Number: Sorts numerically.
 + Date: Sorts by date and time.
 + String: Sorts lexicographically, so `"abc"` comes after `"XYZ"`.
 + Boolean: `false` comes after `true`.


 If a property contains a number as a string, that value will be sorted
 alphabetically and not numerically. Documents that do not have a value for the
 specified sort property are ranked lowest.



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Add an ascending sort to a search

```javascript
let newSearch = search
  .documentType("Stores/Products")
  .ascending("sku");
```

## Create a search, add an ascending sort, and run it

```javascript
import wixSearch from 'wix-search';

// ...

wixSearch.search()
  .documentType("Forum/Content")
  .ascending("lastActivityDate")
  .find()
  .then( (results) => {
    if(results.documents.length > 0) {
      let documents = results.documents;
    } else {
      console.log("No matching results");
    }
  })
  .catch( (error) => {
    console.log(error);
  });


```

## Create a search, add filters, and run it

```javascript
import wixSearch from 'wix-search';

// ...

wixSearch.search()
  .documentType("Stores/Products")
  .eq("onSale", true)
  .hasSome("collections", ["Spring", "Summer"])
  .ascending("sku")
  .find()
  .then( (results) => {
    if(results.documents.length > 0) {
      let documents = results.documents;
    } else {
      console.log("No matching results");
    }
  })
  .catch( (error) => {
    console.log(error);
  });


```

---