db.collection.findOneAndUpdate()

更新的选择条件。可以使用与 find() 方法中相同的 查询选择器 。

要更新集合中返回的第一个文档，请指定空文档 { } 。

如果未指定，则默认为空文档。

如果查询字段不是文档，则该操作将返回错误。

如果没有文档与 filter 匹配，则不更新任何文档。

更新文档或 聚合管道。

• 如果传递的是带有 更新操作符表达式 的文档，则 db.collection.findOneAndUpdate() 将执行指定的修改。

  注意

  该文档必须只包含 更新操作符 。您无法指定替换文档 { <field1>: <value1>, ...} 。要使用替换文档，请参阅 db.collection.findOneAndReplace() 。

• 如果传递了 聚合管道 [ <stage1>, <stage2>, ... ] ，则 db.collection.findOneAndUpdate() 将修改每个管道的文档。该管道可以由以下阶段组成：

  • $addFields 及其别名 $set

  • $project 及其别名 $unset

  • $replaceRoot 及其别名 $replaceWith 。

可选。表达 写关注 的文档。省略以使用默认写关注。

{ w: <value>, j: <boolean>, wtimeout: <number> }

可选。待返回字段的子集。

如要返回返回文档中的所有字段，请忽略此参数。

如果投影参数不是文档，则操作会出错。

可选。为 filter 所匹配的文档指定排序顺序。

如果 sort 参数不是文档，则操作错误。

请参阅 cursor.sort() 。

可选。当为 true 时， findOneAndUpdate() 将：

• 如果没有文档与 filter 匹配，则创建一个新文档。有关详细信息，请参阅 更新或插入行为 。插入新文档后返回 null ，除非 returnNewDocument 是 true 。

• 更新与 filter 匹配的单份文档。

为避免多次 更新或插入 ，请确保 filter 字段具有 唯一索引 。

默认值为 false ；即，在未找到匹配项时 不 插入新文档。

可选。

指定用于操作的 排序规则 。

排序规则 允许用户为字符串比较指定特定于语言的规则，例如字母大小写和重音符号规则。

排序规则选项的语法如下：

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

选修的。大量过滤器文档，用于确定针对大量字段的更新操作要修改哪些大量元素。

在更新文档中，使用 $[<identifier>] 筛选后的位置运算符来定义标识符，然后在数组筛选文档中引用该标识符。如果更新文档中未包含某一标识符，则无法获得该标识符的数组筛选文档。

您可以在更新文档中多次包含相同的标识符；但对于更新文档中的每个不同标识符 ( $[identifier] )，您必须 准确指定一个 对应的数组筛选器文档。也就是说，不能为同一个标识符指定多个数组筛选器文档。例如，如果更新语句包含标识符 x （可能多次），则不能为 arrayFilters 指定以下内容，其中包括 x 的 2 个单独的筛选器文档：

// INVALID
[
  { "x.a": { $gt: 85 } },
  { "x.b": { $gt: 80 } }
]

但是，您可以在单个过滤器文档中的同一标识符上指定复合条件，例如以下示例：

// Example 1
[
  { $or: [{"x.a": {$gt: 85}}, {"x.b": {$gt: 80}}] }
]
// Example 2
[
  { $and: [{"x.a": {$gt: 85}}, {"x.b": {$gt: 80}}] }
]
// Example 3
[
  { "x.a": { $gt: 85 }, "x.b": { $gt: 80 } }
]