truncate #

Truncate the collection, removing all stored documents but keeping all associated mappings.

This method is a lot faster than removing all documents using multiple delete requests.

---

truncate([options], [callback]) #

Arguments	Type	Description
options	JSON Object	Optional parameters
callback	function	Optional callback

---

Options #

Option	Type	Description	Default
queuable	boolean	Make this request queuable or not	true
refresh	string	If set to wait_for, Kuzzle will wait for the persistence layer to finish indexing (available with Elasticsearch 5.x and above)	undefined

---

Return Value #

Returns the Collection object to allow chaining.

---

Callback Response #

Returns a JSON object containing the raw Kuzzle response.

Usage #

Copied to clipboard!

// Using callbacks (NodeJS or Web Browser)
kuzzle
  .collection('collection', 'index')
  .truncate(function (error, result) {
    // callback called once the truncate operation has completed
    // => the result is a JSON object containing the raw Kuzzle response
  });
// Using promises (NodeJS only)
kuzzle
  .collection('collection', 'index')
  .truncatePromise()
  .then(result => {
    // promise resolved once the truncate operation has completed
    // => the result is a JSON object containing the raw Kuzzle response
  });

Callback response:

Copied to clipboard!

{
  "status": 200,
  "error": null,
  "requestId": "8fdc0efb-6fc7-427d-a3a1-fd8cf5eabc20",
  "controller": "admin",
  "action": "truncateCollection",
  "collection": "name of the truncated collection",
  "index": "name of the index containing the truncated collection",
  "volatile": {},
  "state": "done",
  "result": { "acknowledged": true }
}