Removing documents

db.remove(query, options, callback) will remove all documents matching query according to options

  • query is the same as the ones used for finding and updating
  • options only one option for now: multi which allows the removal of multiple documents if set to true. Default is false
  • callback is optional, signature: err, numRemoved
  1. // Let's use the same example collection as in the "finding document" part
  2. // { _id: 'id1', planet: 'Mars', system: 'solar', inhabited: false }
  3. // { _id: 'id2', planet: 'Earth', system: 'solar', inhabited: true }
  4. // { _id: 'id3', planet: 'Jupiter', system: 'solar', inhabited: false }
  5. // { _id: 'id4', planet: 'Omicron Persia 8', system: 'futurama', inhabited: true }
  7. // Remove one document from the collection
  8. // options set to {} since the default for multi is false
  9. db.remove({ _id: 'id2' }, {}, function (err, numRemoved) {
  10.   // numRemoved = 1
  11. });
  13. // Remove multiple documents
  14. db.remove({ system: 'solar' }, { multi: true }, function (err, numRemoved) {
  15.   // numRemoved = 3
  16.   // All planets from the solar system were removed
  17. });
  19. // Removing all documents with the 'match-all' query
  20. db.remove({}, { multi: true }, function (err, numRemoved) {
  21. });