find One And Update
Atomically find a document and update it.
Use this method to only update the corresponding fields in the document according to the update operators used in the update document. To replace the entire document with a new document, use the corresponding findOneAndReplace method.
Note: Supports retryable writes on MongoDB server versions 3.6 or higher when the retryWrites setting is enabled.
Return
the document that was updated. Depending on the value of the returnOriginal
property, this will either be the document as it was before the update or as it is after the update. If no documents matched the query filter, then null will be returned
Parameters
a document describing the query filter, which may not be null.
a document describing the update, which may not be null. The update to apply must include at least one update operator.
the options to apply to the operation
See also
Atomically find a document and update it.
Use this method to only update the corresponding fields in the document according to the update operators used in the update document. To replace the entire document with a new document, use the corresponding findOneAndReplace method.
Note: Supports retryable writes on MongoDB server versions 3.6 or higher when the retryWrites setting is enabled.
Return
the document that was updated. Depending on the value of the returnOriginal
property, this will either be the document as it was before the update or as it is after the update. If no documents matched the query filter, then null will be returned
Parameters
the client session with which to associate this operation
a document describing the query filter, which may not be null.
a document describing the update, which may not be null. The update to apply must include at least one update operator.
the options to apply to the operation
See also
Atomically find a document and update it.
Note: Supports retryable writes on MongoDB server versions 3.6 or higher when the retryWrites setting is enabled.
Return
the document that was updated. Depending on the value of the returnOriginal
property, this will either be the document as it was before the update or as it is after the update. If no documents matched the query filter, then null will be returned
Parameters
a document describing the query filter, which may not be null.
a pipeline describing the update, which may not be null.
the options to apply to the operation
Atomically find a document and update it.
Note: Supports retryable writes on MongoDB server versions 3.6 or higher when the retryWrites setting is enabled.
Return
the document that was updated. Depending on the value of the returnOriginal
property, this will either be the document as it was before the update or as it is after the update. If no documents matched the query filter, then null will be returned
Parameters
the client session with which to associate this operation
a document describing the query filter, which may not be null.
a pipeline describing the update, which may not be null.
the options to apply to the operation