'use strict' const commit = require('../operations/commit') const { DB_OPS: { UPDATE } } = require('../constants') const { pick, omit, isObject } = require('lodash') const { JoiRG, validate, checkValidation } = require('../routes/helpers') const { UPDATE_BODY_SCHEMA } = require('../routes/schemas') const shallowOptKeys = ['returnNew', 'returnOld', 'silent'] const optionsSchema = JoiRG.object().keys({ returnNew: JoiRG.boolean(), returnOld: JoiRG.boolean(), silent: JoiRG.boolean(), ignoreRevs: JoiRG.boolean(), keepNull: JoiRG.boolean(), mergeObjects: JoiRG.boolean() }) const providerSchemas = [JoiRG.string().collection().required(), UPDATE_BODY_SCHEMA, optionsSchema] function updateSingle ({ pathParams, body }, options, deepOpts) { let shallowOpts if (!isObject(deepOpts)) { shallowOpts = pick(options, shallowOptKeys) deepOpts = omit(options, shallowOptKeys) } else { shallowOpts = options } return commit( pathParams.collection, body, UPDATE, shallowOpts, deepOpts ) } function updateMultiple ({ pathParams, body }, options) { const shallowOpts = pick(options, shallowOptKeys) const deepOpts = omit(options, shallowOptKeys) const nodes = [] body.forEach(node => { try { nodes.push( updateSingle({ pathParams, body: node }, shallowOpts, deepOpts) ) } catch (e) { console.error(e.stack) nodes.push(e) } }) return nodes }


Updates an existing document or documents and updates the tracking index.


  • collection - The collection into which to update the document.
  • data - An object or array of objects containing document fields and values to be updated.
  • options - An optional object, containing any combination of the following keys:
    • returnNew - Whether to return the newly updated object. Default false.
    • returnOld - Whether to return the old object. Default false.
    • silent - Whether to return anything in the result. Default false.
    • ignoreRevs - Whether to ignore a revision match before update. Default true.
    • keepNull - Whether to keep keys with null values. Default true..
    • mergeObjects - Whether to merge objects instead of replacing them. Default true.


The contents of the result returned by the method is identical to the contents of the response body of the corresponding HTTP API, invoked with identical input, except when the method throws an error. In the latter case, the error message would be identical to the error response of the HTTP call.


If data is a single object, then any error that occurs while executing the method is thrown back to the caller.

If, on the other hand, data is an array of objects, then the method always returns an array of results. For every element of the data array which incurs an error, the error object is present at the corresponding index in the result array. For every input element that the method handles successfully, the result array contains an element that is identical to the result that would have been returned had the method been invoked singly for this element, with identical options.


  1. Update a single document silently:
     { _key: 'abc', x: 1, y: 2 },
     { silent: true }
  2. Update an array of documents and return the new documents (full content rather just the meta information):
    updateProvider('edge_collection', [
       // Perform a rev match before update.
       { x: 1, y: 2, _key: 'abc', _rev: 'xyz' },
       { x: 2, y: 1, _id: 'edge_collection/def' },
       { x: 0, y: 0, _key: 'xyz', _id: 'edge_collection/xyz' }
     { returnNew: true }
function updateProvider (collection, data, options = {}) { const result = validate([collection, data, options], providerSchemas) checkValidation(result) const args = result.values collection = args[0] data = args[1] options = args[2] const req = { pathParams: { collection }, body: data } if (Array.isArray(data)) { return updateMultiple(req, options) } else { const shallowOpts = pick(options, shallowOptKeys) const deepOpts = omit(options, shallowOptKeys) return updateSingle(req, shallowOpts, deepOpts) } } module.exports = { updateSingle, updateMultiple, updateProvider }