Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/meilisearch/meilisearch-js

JavaScript client for the Meilisearch API
https://github.com/meilisearch/meilisearch-js
client javascript meilisearch nodejs sdk
Last synced: 2 months ago
JSON representation
JavaScript client for the Meilisearch API
Host: GitHub
URL: https://github.com/meilisearch/meilisearch-js
Owner: meilisearch
License: mit
Created: 2019-10-02T15:37:57.000Z (over 5 years ago)
Default Branch: main
Last Pushed: 2024-10-23T19:46:55.000Z (3 months ago)
Last Synced: 2024-10-28T07:01:28.408Z (3 months ago)
Topics: client, javascript, meilisearch, nodejs, sdk
Language: TypeScript
Homepage: https://www.meilisearch.com
Size: 11.7 MB
Stars: 744
Watchers: 16
Forks: 88
Open Issues: 16
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project

my-awesome-list - meilisearch-js
awesome-meilisearch - JavaScript
README

        


  



Meilisearch JavaScript




  Meilisearch |

  Meilisearch Cloud |

  Documentation |

  Discord |

  Roadmap |

  Website |

  FAQ





  

  

  

    

  

  

  

  



⚡ The Meilisearch API client written for JavaScript


**Meilisearch JavaScript** is the Meilisearch API client for JavaScript developers.

**Meilisearch** is an open-source search engine. [Learn more about Meilisearch.](https://github.com/meilisearch/meilisearch)

## Table of Contents 

- [📖 Documentation](#-documentation)

- [⚡ Supercharge your Meilisearch experience](#-supercharge-your-meilisearch-experience)

- [🔧 Installation](#-installation)

- [🎬 Getting started](#-getting-started)

- [🤖 Compatibility with Meilisearch](#-compatibility-with-meilisearch)

- [💡 Learn more](#-learn-more)

- [⚙️ Contributing](#️-contributing)

- [📜 API resources](#-api-resources)

## 📖 Documentation

This readme and [Meilisearch JS documentation website](https://meilisearch.github.io/meilisearch-js/) contains all the information you need to start using this Meilisearch SDK.

For general information on how to use Meilisearch—such as our API reference, tutorials, guides, and in-depth articles—refer to our [main documentation website](https://www.meilisearch.com/docs/).

## ⚡ Supercharge your Meilisearch experience

Say goodbye to server deployment and manual updates with [Meilisearch Cloud](https://www.meilisearch.com/cloud?utm_campaign=oss&utm_source=github&utm_medium=meilisearch-js). Get started with a 14-day free trial! No credit card required.

## 🔧 Installation

We recommend installing `meilisearch-js` in your project with your package manager of choice.

```sh

npm install meilisearch

```

`meilisearch-js` officially supports `node` versions >= 14 and <= 18.

Instead of using a package manager, you may also import the library directly into your [HTML via a CDN](#include-script-tag).

### Run Meilisearch 

To use one of our SDKs, you must first have a running Meilisearch instance. Consult our documentation for [instructions on how to download and launch Meilisearch](https://www.meilisearch.com/docs/learn/getting_started/installation#installation).

### Import 

After installing `meilisearch-js`, you must import it into your application. There are many ways of doing that depending on your development environment.

#### `import` syntax 

Usage in an ES module environment:

```javascript

import { MeiliSearch } from 'meilisearch'

const client = new MeiliSearch({

  host: 'http://127.0.0.1:7700',

  apiKey: 'masterKey',

})

```

#### `` tag <!-- omit in toc -->

Usage in an HTML (or alike) file:

```html

<script src='https://cdn.jsdelivr.net/npm/meilisearch@latest/dist/bundles/meilisearch.umd.js'>

  const client = new MeiliSearch({

    host: 'http://127.0.0.1:7700',

    apiKey: 'masterKey',

  })

```

#### `require` syntax 

Usage in a back-end node.js or another environment supporting CommonJS modules:

```javascript

const { MeiliSearch } = require('meilisearch')

const client = new MeiliSearch({

  host: 'http://127.0.0.1:7700',

  apiKey: 'masterKey',

})

```

#### React Native 

To use `meilisearch-js` with React Native, you must also install [react-native-url-polyfill](https://www.npmjs.com/package/react-native-url-polyfill).

#### Deno

Usage in a Deno environment:

```js

import { MeiliSearch } from "https://esm.sh/meilisearch"

const client = new MeiliSearch({

  host: 'http://127.0.0.1:7700',

  apiKey: 'masterKey',

})

```

## 🎬 Getting started

### Add documents 

```js

const { MeiliSearch } = require('meilisearch')

// Or if you are in a ES environment

import { MeiliSearch } from 'meilisearch'

;(async () => {

  const client = new MeiliSearch({

    host: 'http://127.0.0.1:7700',

    apiKey: 'masterKey',

  })

  // An index is where the documents are stored.

  const index = client.index('movies')

  const documents = [

      { id: 1, title: 'Carol', genres: ['Romance', 'Drama'] },

      { id: 2, title: 'Wonder Woman', genres: ['Action', 'Adventure'] },

      { id: 3, title: 'Life of Pi', genres: ['Adventure', 'Drama'] },

      { id: 4, title: 'Mad Max: Fury Road', genres: ['Adventure', 'Science Fiction'] },

      { id: 5, title: 'Moana', genres: ['Fantasy', 'Action']},

      { id: 6, title: 'Philadelphia', genres: ['Drama'] },

  ]

  // If the index 'movies' does not exist, Meilisearch creates it when you first add the documents.

  let response = await index.addDocuments(documents)

  console.log(response) // => { "uid": 0 }

})()

```

Tasks such as document addition always return a unique identifier. You can use this identifier `taskUid` to check the status (`enqueued`, `canceled`, `processing`, `succeeded` or `failed`) of a [task](https://www.meilisearch.com/docs/reference/api/tasks).

### Basic search 

```javascript

// Meilisearch is typo-tolerant:

const search = await index.search('philoudelphia')

console.log(search)

```

Output:

```json

{

  "hits": [

    {

      "id": "6",

      "title": "Philadelphia",

      "genres": ["Drama"]

    }

  ],

  "offset": 0,

  "limit": 20,

  "estimatedTotalHits": 1,

  "processingTimeMs": 1,

  "query": "philoudelphia"

}

```

### Using search parameters 

`meilisearch-js` supports all [search parameters](https://www.meilisearch.com/docs/reference/api/search#search-parameters) described in our main documentation website.

```javascript

await index.search(

  'wonder',

  {

    attributesToHighlight: ['*']

  }

)

```

```json

{

  "hits": [

    {

      "id": 2,

      "title": "Wonder Woman",

      "genres": ["Action", "Adventure"],

      "_formatted": {

        "id": "2",

        "title": "Wonder Woman",

        "genres": ["Action", "Adventure"]

      }

    }

  ],

  "offset": 0,

  "limit": 20,

  "estimatedTotalHits": 1,

  "processingTimeMs": 0,

  "query": "wonder"

}

```

### Custom search with filters 

To enable filtering, you must first add your attributes to the [`filterableAttributes` index setting](https://www.meilisearch.com/docs/reference/api/settings#filterable-attributes).

```js

await index.updateFilterableAttributes([

    'id',

    'genres'

  ])

```

You only need to perform this operation once per index.

Note that Meilisearch rebuilds your index whenever you update `filterableAttributes`. Depending on the size of your dataset, this might take considerable time. You can track the process using the [tasks API](https://www.meilisearch.com/docs/reference/api/tasks)).

After you configured `filterableAttributes`, you can use the [`filter` search parameter](https://www.meilisearch.com/docs/reference/api/search#filter) to refine your search:

```js

await index.search(

  'wonder',

  {

    filter: ['id > 1 AND genres = Action']

  }

)

```

```json

{

  "hits": [

    {

      "id": 2,

      "title": "Wonder Woman",

      "genres": ["Action","Adventure"]

    }

  ],

  "offset": 0,

  "limit": 20,

  "estimatedTotalHits": 1,

  "processingTimeMs": 0,

  "query": "wonder"

}

```

### Placeholder search 

Placeholder search makes it possible to receive hits based on your parameters without having any query (`q`). For example, in a movies database you can run an empty query to receive all results filtered by `genre`.

```javascript

await index.search(

  '',

  {

    filter: ['genres = fantasy'],

    facets: ['genres']

  }

)

```

```json

{

  "hits": [

    {

      "id": 2,

      "title": "Wonder Woman",

      "genres": ["Action","Adventure"]

    },

    {

      "id": 5,

      "title": "Moana",

      "genres": ["Fantasy","Action"]

    }

  ],

  "offset": 0,

  "limit": 20,

  "estimatedTotalHits": 2,

  "processingTimeMs": 0,

  "query": "",

  "facetDistribution": {

    "genres": {

      "Action": 2,

      "Fantasy": 1,

      "Adventure": 1

    }

  }

}

```

Note that to enable faceted search on your dataset you need to add `genres` to the `filterableAttributes` index setting. For more information on filtering and faceting, [consult our documentation settings](https://www.meilisearch.com/docs/learn/fine_tuning_results/faceted_search).

#### Abortable search 

You can abort a pending search request by providing an [AbortSignal](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) to the request.

```js

const controller = new AbortController()

index

  .search('wonder', {}, {

    signal: controller.signal,

  })

  .then((response) => {

    /** ... */

  })

  .catch((e) => {

    /** Catch AbortError here. */

  })

controller.abort()

```

### Using Meilisearch behind a proxy 

#### Custom request config 

You can provide a custom request configuration. for example, with custom headers.

```ts

const client: MeiliSearch = new MeiliSearch({

  host: 'http://localhost:3000/api/meilisearch/proxy',

  requestConfig: {

    headers: {

      Authorization: AUTH_TOKEN

    },

    // OR

    credentials: 'include'

  }

})

```

#### Custom http client 

You can use your own HTTP client, for example, with [`axios`](https://github.com/axios/axios).

```ts

const client: MeiliSearch = new MeiliSearch({

  host: 'http://localhost:3000/api/meilisearch/proxy',

  httpClient: async (url, opts) => {

    const response = await $axios.request({

      url,

      data: opts?.body,

      headers: opts?.headers,

      method: (opts?.method?.toLocaleUpperCase() as Method) ?? 'GET'

    })

    return response.data

  }

})

```

## 🤖 Compatibility with Meilisearch

This package guarantees compatibility with [version v1.x of Meilisearch](https://github.com/meilisearch/meilisearch/releases/latest), but some features may not be present. Please check the [issues](https://github.com/meilisearch/meilisearch-js/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22+label%3Aenhancement) for more info.

## 💡 Learn more

The following sections in our main documentation website may interest you:

- **Manipulate documents**: see the [API references](https://www.meilisearch.com/docs/reference/api/documents) or read more about [documents](https://www.meilisearch.com/docs/learn/core_concepts/documents).

- **Search**: see the [API references](https://www.meilisearch.com/docs/reference/api/search) or follow our guide on [search parameters](https://www.meilisearch.com/docs/reference/api/search#search-parameters).

- **Manage the indexes**: see the [API references](https://www.meilisearch.com/docs/reference/api/indexes) or read more about [indexes](https://www.meilisearch.com/docs/learn/core_concepts/indexes).

- **Configure the index settings**: see the [API references](https://www.meilisearch.com/docs/reference/api/settings) or follow our guide on [settings parameters](https://www.meilisearch.com/docs/reference/api/settings#settings_parameters).

This repository also contains [more examples](./examples).

## ⚙️ Contributing

We welcome all contributions, big and small! If you want to know more about this SDK's development workflow or want to contribute to the repo, please visit our [contributing guidelines](/CONTRIBUTING.md) for detailed instructions.

## 📜 API resources

### Search 

#### [Make a search request](https://www.meilisearch.com/docs/reference/api/search)

```ts

client.index('xxx').search(query: string, options: SearchParams = {}, config?: Partial): Promise>

```

#### [Make a search request using the GET method (slower than the search method)](https://www.meilisearch.com/docs/reference/api/search#search-in-an-index-with-get-route)

```ts

client.index('xxx').searchGet(query: string, options: SearchParams = {}, config?: Partial): Promise>

```

### Multi Search

#### [Make multiple search requests](https://www.meilisearch.com/docs/reference/api/multi_search#multi-search)

```ts

client.multiSearch(queries?: MultiSearchParams, config?: Partial): Promise>>

```

`multiSearch` uses the `POST` method when performing its request to Meilisearch.

### Search For Facet Values

#### [Search for facet values](https://www.meilisearch.com/docs/reference/api/facet_search#perform-a-facet-search)

```ts

client.index('myIndex').searchForFacetValues(params: SearchForFacetValuesParams, config?: Partial): Promise

```

### Documents 

#### [Add or replace multiple documents](https://www.meilisearch.com/docs/reference/api/documents#add-or-replace-documents)

```ts

client.index('myIndex').addDocuments(documents: Document[]): Promise

```

#### [Add or replace multiple documents in string format](https://www.meilisearch.com/docs/reference/api/documents#add-or-update-documents)

```ts

client.index('myIndex').addDocumentsFromString(documents: string, contentType: ContentType, queryParams: RawDocumentAdditionOptions): Promise

```

#### [Add or replace multiple documents in batches](https://www.meilisearch.com/docs/reference/api/documents#add-or-replace-documents)

```ts

client.index('myIndex').addDocumentsInBatches(documents: Document[], batchSize = 1000): Promise

```

#### [Add or update multiple documents](https://www.meilisearch.com/docs/reference/api/documents#add-or-update-documents)

```ts

client.index('myIndex').updateDocuments(documents: Array>>): Promise

```

#### [Add or update multiple documents in string format](https://www.meilisearch.com/docs/reference/api/documents#add-or-update-documents)

```ts

client.index('myIndex').updateDocumentsFromString(documents: string, contentType: ContentType, queryParams: RawDocumentAdditionOptions): Promise

```

#### [Add or update multiple documents in batches](https://www.meilisearch.com/docs/reference/api/documents#add-or-update-documents)

```ts

client.index('myIndex').updateDocumentsInBatches(documents: Array>>, batchSize = 1000): Promise

```

#### [Get Documents](https://www.meilisearch.com/docs/reference/api/documents#get-documents)

```ts

client.index.getDocuments(parameters: DocumentsQuery = {}): Promise>>

```

#### [Get one document](https://www.meilisearch.com/docs/reference/api/documents#get-one-document)

```ts

client.index('myIndex').getDocument(documentId: string): Promise>

```

#### [Delete one document](https://www.meilisearch.com/docs/reference/api/documents#delete-one-document)

```ts

client.index('myIndex').deleteDocument(documentId: string | number): Promise

```

#### [Delete multiple documents](https://www.meilisearch.com/docs/reference/api/documents#delete-documents)

```ts

client.index('myIndex').deleteDocuments(params: DocumentsDeletionQuery | DocumentsIds): Promise

```

#### [Delete all documents](https://www.meilisearch.com/docs/reference/api/documents#delete-all-documents)

```ts

client.index('myIndex').deleteAllDocuments(): Promise

```

### Tasks 

#### [Get all tasks](https://www.meilisearch.com/docs/reference/api/tasks#get-all-tasks)

```ts

client.getTasks(parameters: TasksQuery): Promise

```

#### [Get one task](https://www.meilisearch.com/docs/reference/api/tasks)

```ts

client.getTask(uid: number): Promise

```

#### [Delete tasks](https://www.meilisearch.com/docs/reference/api/tasks#delete-tasks)

```ts

client.deleteTasks(parameters: DeleteTasksQuery = {}): Promise

```

#### [Cancel tasks](https://www.meilisearch.com/docs/reference/api/tasks#cancel-tasks)

```ts

client.cancelTasks(parameters: CancelTasksQuery = {}): Promise

```

#### [Get all tasks of an index](https://www.meilisearch.com/docs/reference/api/tasks#get-all-tasks-by-index)

```ts

client.index('myIndex').getTasks(parameters: TasksQuery): Promise

```

#### [Get one task of an index](https://www.meilisearch.com/docs/reference/api/tasks)

```ts

client.index('myIndex').getTask(uid: number): Promise

```

#### Wait for one task

##### Using the client

```ts

client.waitForTask(uid: number, { timeOutMs?: number, intervalMs?: number }): Promise

```

##### Using the index

```ts

client.index('myIndex').waitForTask(uid: number, { timeOutMs?: number, intervalMs?: number }): Promise

```

#### Wait for multiple tasks

##### Using the client

```ts

client.waitForTasks(uids: number[], { timeOutMs?: number, intervalMs?: number }): Promise

```

##### Using the index

```ts

client.index('myIndex').waitForTasks(uids: number[], { timeOutMs?: number, intervalMs?: number }): Promise

```

### Indexes 

#### [Get all indexes in Index instances](https://www.meilisearch.com/docs/reference/api/indexes#list-all-indexes)

```ts

client.getIndexes(parameters: IndexesQuery): Promise>

```

#### [Get all indexes](https://www.meilisearch.com/docs/reference/api/indexes#list-all-indexes)

```ts

client.getRawIndexes(parameters: IndexesQuery): Promise>

```

#### [Create a new index](https://www.meilisearch.com/docs/reference/api/indexes#create-an-index)

```ts

client.createIndex(uid: string, options?: IndexOptions): Promise

```

#### Create a local reference to an index

```ts

client.index(uid: string): Index

```

#### [Get an index instance completed with information fetched from Meilisearch](https://www.meilisearch.com/docs/reference/api/indexes#get-one-index)

```ts

client.getIndex(uid: string): Promise>

```

#### [Get the raw index JSON response from Meilisearch](https://www.meilisearch.com/docs/reference/api/indexes#get-one-index)

```ts

client.getRawIndex(uid: string): Promise

```

#### [Get an object with information about the index](https://www.meilisearch.com/docs/reference/api/indexes#get-one-index)

```ts

client.index('myIndex').getRawInfo(): Promise

```

#### [Update Index](https://www.meilisearch.com/docs/reference/api/indexes#update-an-index)

##### Using the client

```ts

client.updateIndex(uid: string, options: IndexOptions): Promise

```

##### Using the index object

```ts

client.index('myIndex').update(data: IndexOptions): Promise

```

#### [Delete index](https://www.meilisearch.com/docs/reference/api/indexes#delete-an-index)

##### Using the client

```ts

client.deleteIndex(uid): Promise

```

##### Using the index object

```ts

client.index('myIndex').delete(): Promise

```

#### [Get specific index stats](https://www.meilisearch.com/docs/reference/api/stats#get-stats-of-an-index)

```ts

client.index('myIndex').getStats(): Promise

```

##### Return Index instance with updated information

```ts

client.index('myIndex').fetchInfo(): Promise

```

##### Get Primary Key of an Index

```ts

client.index('myIndex').fetchPrimaryKey(): Promise

```

##### Swap two indexes

```ts

client.swapIndexes(params: SwapIndexesParams): Promise

```

### Settings 

#### [Get settings](https://www.meilisearch.com/docs/reference/api/settings#get-settings)

```ts

client.index('myIndex').getSettings(): Promise

```

#### [Update settings](https://www.meilisearch.com/docs/reference/api/settings#update-settings)

```ts

client.index('myIndex').updateSettings(settings: Settings): Promise

```

#### [Reset settings](https://www.meilisearch.com/docs/reference/api/settings#reset-settings)

```ts

client.index('myIndex').resetSettings(): Promise

```

### Pagination Settings

#### [Get pagination](https://www.meilisearch.com/docs/reference/api/settings#get-pagination-settings)

```ts

client.index('myIndex').getPagination(): Promise

```

#### [Update pagination](https://www.meilisearch.com/docs/reference/api/settings#update-pagination-settings)

```ts

client.index('myIndex').updatePagination(pagination: PaginationSettings): Promise

```

#### [Reset pagination](https://www.meilisearch.com/docs/reference/api/settings#reset-pagination-settings)

```ts

client.index('myIndex').resetPagination(): Promise

```

### Synonyms 

#### [Get synonyms](https://www.meilisearch.com/docs/reference/api/settings#get-synonyms)

```ts

client.index('myIndex').getSynonyms(): Promise

```

#### [Update synonyms](https://www.meilisearch.com/docs/reference/api/settings#update-synonyms)

```ts

client.index('myIndex').updateSynonyms(synonyms: Synonyms): Promise

```

#### [Reset synonyms](https://www.meilisearch.com/docs/reference/api/settings#reset-synonyms)

```ts

client.index('myIndex').resetSynonyms(): Promise

```

### Stop words 

#### [Get stop words](https://www.meilisearch.com/docs/reference/api/settings#get-stop-words)

```ts

client.index('myIndex').getStopWords(): Promise

```

#### [Update stop words](https://www.meilisearch.com/docs/reference/api/settings#update-stop-words)

```ts

client.index('myIndex').updateStopWords(stopWords: string[] | null ): Promise

```

#### [Reset stop words](https://www.meilisearch.com/docs/reference/api/settings#reset-stop-words)

```ts

client.index('myIndex').resetStopWords(): Promise

```

### Ranking rules 

#### [Get ranking rules](https://www.meilisearch.com/docs/reference/api/settings#get-ranking-rules)

```ts

client.index('myIndex').getRankingRules(): Promise

```

#### [Update ranking rules](https://www.meilisearch.com/docs/reference/api/settings#update-ranking-rules)

```ts

client.index('myIndex').updateRankingRules(rankingRules: string[] | null): Promise

```

#### [Reset ranking rules](https://www.meilisearch.com/docs/reference/api/settings#reset-ranking-rules)

```ts

client.index('myIndex').resetRankingRules(): Promise

```

### Distinct Attribute 

#### [Get distinct attribute](https://www.meilisearch.com/docs/reference/api/settings#get-distinct-attribute)

```ts

client.index('myIndex').getDistinctAttribute(): Promise

```

#### [Update distinct attribute](https://www.meilisearch.com/docs/reference/api/settings#update-distinct-attribute)

```ts

client.index('myIndex').updateDistinctAttribute(distinctAttribute: string | null): Promise

```

#### [Reset distinct attribute](https://www.meilisearch.com/docs/reference/api/settings#reset-distinct-attribute)

```ts

client.index('myIndex').resetDistinctAttribute(): Promise

```

### Searchable attributes 

#### [Get searchable attributes](https://www.meilisearch.com/docs/reference/api/settings#get-searchable-attributes)

```ts

client.index('myIndex').getSearchableAttributes(): Promise

```

#### [Update searchable attributes](https://www.meilisearch.com/docs/reference/api/settings#update-searchable-attributes)

```ts

client.index('myIndex').updateSearchableAttributes(searchableAttributes: string[] | null): Promise

```

#### [Reset searchable attributes](https://www.meilisearch.com/docs/reference/api/settings#reset-searchable-attributes)

```ts

client.index('myIndex').resetSearchableAttributes(): Promise

```

### Displayed attributes 

#### [Get displayed attributes](https://www.meilisearch.com/docs/reference/api/settings#get-displayed-attributes)

```ts

client.index('myIndex').getDisplayedAttributes(): Promise

```

#### [Update displayed attributes](https://www.meilisearch.com/docs/reference/api/settings#update-displayed-attributes)

```ts

client.index('myIndex').updateDisplayedAttributes(displayedAttributes: string[] | null): Promise

```

#### [Reset displayed attributes](https://www.meilisearch.com/docs/reference/api/settings#reset-displayed-attributes)

```ts

client.index('myIndex').resetDisplayedAttributes(): Promise

```

### Filterable attributes 

#### [Get filterable attributes](https://www.meilisearch.com/docs/reference/api/settings#get-filterable-attributes)

```ts

client.index('myIndex').getFilterableAttributes(): Promise

```

#### [Update filterable attributes](https://www.meilisearch.com/docs/reference/api/settings#update-filterable-attributes)

```ts

client.index('myIndex').updateFilterableAttributes(filterableAttributes: string[] | null): Promise

```

#### [Reset filterable attributes](https://www.meilisearch.com/docs/reference/api/settings#reset-filterable-attributes)

```ts

client.index('myIndex').resetFilterableAttributes(): Promise

```

### Sortable attributes 

#### [Get sortable attributes](https://www.meilisearch.com/docs/reference/api/settings#get-sortable-attributes)

```ts

client.index('myIndex').getSortableAttributes(): Promise

```

#### [Update sortable attributes](https://www.meilisearch.com/docs/reference/api/settings#update-sortable-attributes)

```ts

client.index('myIndex').updateSortableAttributes(sortableAttributes: string[] | null): Promise

```

#### [Reset sortable attributes](https://www.meilisearch.com/docs/reference/api/settings#reset-sortable-attributes)

```ts

client.index('myIndex').resetSortableAttributes(): Promise

```

### Faceting 

#### [Get faceting](https://www.meilisearch.com/docs/reference/api/settings#get-faceting-settings)

```ts

client.index('myIndex').getFaceting(): Promise

```

#### [Update faceting](https://www.meilisearch.com/docs/reference/api/settings#update-faceting-settings)

```ts

client.index('myIndex').updateFaceting(faceting: Faceting): Promise

```

#### [Reset faceting](https://www.meilisearch.com/docs/reference/api/settings#reset-faceting-settings)

```ts

client.index('myIndex').resetFaceting(): Promise

```

### Typo tolerance 

#### [Get typo tolerance](https://www.meilisearch.com/docs/reference/api/settings#get-typo-tolerance-settings)

```ts

client.index('myIndex').getTypoTolerance(): Promise

```

#### [Update typo tolerance](https://www.meilisearch.com/docs/reference/api/settings#update-typo-tolerance-settings)

```ts

client.index('myIndex').updateTypoTolerance(typoTolerance: TypoTolerance | null): Promise

```

#### [Reset typo tolerance](https://www.meilisearch.com/docs/reference/api/settings#reset-typo-tolerance-settings)

```ts

client.index('myIndex').resetTypoTolerance(): Promise

```

### Separator tokens 

#### [Get separator tokens](https://www.meilisearch.com/docs/reference/api/settings#get-separator-tokens)

```ts

client.index('myIndex').getSeparatorTokens(): Promise

```

#### [Update separator tokens](https://www.meilisearch.com/docs/reference/api/settings#update-separator-tokens)

```ts

client.index('myIndex').updateSeparatorTokens(separatorTokens: SeparatorTokens | null): Promise

```

#### [Reset separator tokens](https://www.meilisearch.com/docs/reference/api/settings#reset-separator-tokens)

```ts

client.index('myIndex').resetSeparatorTokens(): Promise

```

### Non Separator tokens 

#### [Get non separator tokens](https://www.meilisearch.com/docs/reference/api/settings#get-non-separator-tokens)

```ts

client.index('myIndex').getNonSeparatorTokens(): Promise

```

#### [Update non separator tokens](https://www.meilisearch.com/docs/reference/api/settings#update-non-separator-tokens)

```ts

client.index('myIndex').updateNonSeparatorTokens(nonSeparatorTokens: NonSeparatorTokens | null): Promise

```

#### [Reset non separator tokens](https://www.meilisearch.com/docs/reference/api/settings#reset-non-separator-tokens)

```ts

client.index('myIndex').resetNonSeparatorTokens(): Promise

```

### Dictionary 

#### [Get dictionary](https://www.meilisearch.com/docs/reference/api/settings#get-dictionary)

```ts

client.index('myIndex').getDictionary(): Promise

```

#### [Update dictionary](https://www.meilisearch.com/docs/reference/api/settings#update-dictionary)

```ts

client.index('myIndex').updateDictionary(dictionary: Dictionary | null): Promise

```

#### [Reset dictionary](https://www.meilisearch.com/docs/reference/api/settings#reset-dictionary)

```ts

client.index('myIndex').resetDictionary(): Promise

```

### Proximity Precision 

#### [Get proximity precision](https://www.meilisearch.com/docs/reference/api/settings#get-proximity-precision-settings)

```ts

client.index('myIndex').getProximityPrecision(): Promise

```

#### [Update proximity precision](https://www.meilisearch.com/docs/reference/api/settings#update-proximity-precision-settings)

```ts

client.index('myIndex').updateProximityPrecision(proximityPrecision: ProximityPrecision): Promise

```

#### [Reset proximity precision](https://www.meilisearch.com/docs/reference/api/settings#reset-proximity-precision-settings)

```ts

client.index('myIndex').resetProximityPrecision(): Promise

```

### Embedders 

⚠️ This feature is experimental. Activate the [`vectorStore` experimental feature to use it](https://www.meilisearch.com/docs/reference/api/experimental_features#configure-experimental-features)

#### Get embedders

```ts

client.index('myIndex').getEmbedders(): Promise

```

#### Update embedders

```ts

client.index('myIndex').updateEmbedders(embedders: Embedders): Promise

```

#### Reset embedders

```ts

client.index('myIndex').resetEmbedders(): Promise

```

### SearchCutoffMs 

#### [Get SearchCutoffMs](https://www.meilisearch.com/docs/reference/api/settings#get-search-cutoff)

```ts

client.index('myIndex').getSearchCutoffMs(): Promise

```

#### [Update SearchCutoffMs](https://www.meilisearch.com/docs/reference/api/settings#update-search-cutoff)

```ts

client.index('myIndex').updateSearchCutoffMs(searchCutoffMs: SearchCutoffMs): Promise

```

#### [Reset SearchCutoffMs](https://www.meilisearch.com/docs/reference/api/settings#reset-search-cutoff)

```ts

client.index('myIndex').resetSearchCutoffMs(): Promise

```

### Keys 

#### [Get keys](https://www.meilisearch.com/docs/reference/api/keys#get-all-keys)

```ts

client.getKeys(parameters: KeysQuery): Promise

```

#### [Get one key](https://www.meilisearch.com/docs/reference/api/keys#get-one-key)

```ts

client.getKey(keyOrUid: string): Promise

```

#### [Create a key](https://www.meilisearch.com/docs/reference/api/keys#create-a-key)

```ts

client.createKey(options: KeyCreation): Promise

```

#### [Update a key](https://www.meilisearch.com/docs/reference/api/keys#update-a-key)

```ts

client.updateKey(keyOrUid: string, options: KeyUpdate): Promise

```

#### [Delete a key](https://www.meilisearch.com/docs/reference/api/keys#delete-a-key)

```ts

client.deleteKey(keyOrUid: string): Promise

```

### `isHealthy` 

#### [Return `true` or `false` depending on the health of the server](https://www.meilisearch.com/docs/reference/api/health#get-health)

```ts

client.isHealthy(): Promise

```

### Health 

#### [Check if the server is healthy](https://www.meilisearch.com/docs/reference/api/health#get-health)

```ts

client.health(): Promise

```

### Stats 

#### [Get database stats](https://www.meilisearch.com/docs/reference/api/stats#get-stats-of-all-indexes)

```ts

client.getStats(): Promise

```

### Version 

#### [Get binary version](https://www.meilisearch.com/docs/reference/api/version#get-version-of-meilisearch)

```ts

client.getVersion(): Promise

```

### Dumps 

#### [Trigger a dump creation process](https://www.meilisearch.com/docs/reference/api/dump#create-a-dump)

```ts

client.createDump(): Promise

```

### Snapshots 

#### [Trigger a snapshot on-demand process](https://www.meilisearch.com/docs/reference/api/snapshots#create-a-snapshot)

```ts

client.createSnapshot(): Promise

```

---

Meilisearch provides and maintains many SDKs and integration tools like this one. We want to provide everyone with an **amazing search experience for any kind of project**. For a full overview of everything we create and maintain, take a look at the [integration-guides](https://github.com/meilisearch/integration-guides) repository.
Ecosyste.ms: Awesome

https://github.com/meilisearch/meilisearch-js

Awesome Lists containing this project

README

Meilisearch JavaScript

Meilisearch | Meilisearch Cloud | Documentation | Discord | Roadmap | Website | FAQ

Meilisearch |
Meilisearch Cloud |
Documentation |
Discord |
Roadmap |
Website |
FAQ
