read  source  history 

= findOneAndDelete() =
----
[[MongoDB Driver Function Reference]]


Deletes a single document based on the filter and sort criteria, returning the deleted document.
More information can be found in the corresponding entry of the [[https://docs.mongodb.com/manual/reference/method/db.collection.findOneAndDelete/index.html|MongoDB Manual]].


[[[@cG

<collection>.findOneAndDelete(<filter>[, <options>])

]]]


**Arguments**

[[[@w

|@t0@r0@c0 <collection> | | The target collection. |
| <filter> | | A filter expression using [[https://docs.mongodb.com/manual/reference/operator/|query operators]]. |
| <options> | | A BOSN document specifying options. |

]]]


**Options**

[[[@cw

{ projection: <document>, sort: <document>, maxtime: <long>, collation: <document>, hint: <document> }
<<@f:text>>
|@t0@r0@c0 projection | | Defines a subset of fields to return. |
| sort | | Specifies a sort order. |
| maxtime | | Specifies a time limit in milliseconds. |
| collation| | A document specifying the [[https://docs.mongodb.com/manual/reference/bson-type-comparison-order/#collation|collation]]. |
| hint | | A document specifying a [[https://docs.mongodb.com/manual/reference/method/db.collection.deleteMany/#ex-deletemany-hint|hint]]. |
<<@/f>>
]]]


**Example**

[[[@cw

db.employees.findOneAndDelete({ salary: { $gt: 700000 }}, { sort: { age: 1 }});

]]]

Finds document from the employee collection with a salary greater than 700000, sorts them by age, then deletes the first document in the result.



----
[[Main|home]] | [[MongoDB Driver Function Reference]] | [[MongoDB Driver]]