SDK
SDK Javascript v7.x
2

refresh #

Refreshes a collection to reindex the written and deleted documents so they are available in search results.

A refresh operation comes with some performance costs.

From the Elasticsearch documentation:

"While a refresh is much lighter than a commit, it still has a performance cost. A manual refresh can be useful when writing tests, but don’t do a manual refresh every time you index a document in production; it will hurt your performance. Instead, your application needs to be aware of the near real-time nature of Elasticsearch and make allowances for it."


refresh(index, collection, [options]);

ArgumentsTypeDescription
options
object
Query options

options #

Additional query options

PropertyType
(default)
Description
queuable
boolean

(true)
If true, queues the request during downtime, until connected to Kuzzle again
timeout
number

(-1)
Time (in ms) during which a request will still be waited to be resolved. Set it -1 if you want to wait indefinitely
triggerEvents
boolean

(false)
If set to true, will trigger events even if using Embeded SDK. You should always ensure that your events/pipes does not create an infinite loop.
Available since Kuzzle 2.31.0

Resolves #

Resolves when the refresh has been done.

Usage #

try {
  await kuzzle.collection.refresh('nyc-open-data', 'yellow-taxi');
  console.log('Refresh successful');
} catch (error) {
  console.error(error.message);
}