Delete a Document删除文件

Note

If you specify a callback method, deleteOne() returns nothing. 如果指定回调方法，deleteOne()将不返回任何内容。If you do not specify one, this method returns a Promise that resolves to the result object when it completes. 如果未指定，此方法将返回一个Promise，该Promise在完成时解析为结果对象。See our guide on Promises and Callbacks for more information, or the API documentation for information on the result object.有关更多信息，请参阅我们的承诺和回调指南，或参阅API文档以了解有关结果对象的信息。

You can delete a single document in a collection with collection.deleteOne(). 可以使用collection.deleteOne()删除集合中的单个文档。The deleteOne() method uses a query document that you provide to match the subset of the documents in the collection that match the query. deleteOne()方法使用您提供的查询文档来匹配集合中与查询匹配的文档子集。If you do not provide a query document (or if you provide an empty document), MongoDB matches all documents in the collection and deletes the first match.如果不提供查询文档（或提供空文档），MongoDB将匹配集合中的所有文档并删除第一个匹配项。

You can specify additional query options using the options object passed as the second parameter of the deleteOne method. 可以使用作为deleteOne方法的第二个参数传递的options对象指定其他查询选项。You can also pass a callback method as an optional third parameter. 还可以将回调方法作为可选的第三个参数传递。For more information on this method, see the deleteOne() API documentation.有关此方法的更多信息，请参阅deleteOne()API文档。

Note

If your application requires the deleted document after deletion, consider using the collection.findOneAndDelete() method, which has a similar interface to deleteOne() but also returns the deleted document.如果您的应用程序在删除后需要删除的文档，请考虑使用collection.findOneAndDelete()方法，该方法具有与deleteOne()类似的接口，但也返回删除的文档。

The following snippet deletes a single document from the movies collection. 以下代码段从movies集合中删除单个文档。It uses a query document that configures the query to match movies with a title value of "Annie Hall".它使用一个查询文档，将查询配置为匹配title值为“Annie Hall”的电影。

Note

You can use this example to connect to an instance of MongoDB and interact with a database that contains sample data. 您可以使用此示例连接到MongoDB实例，并与包含示例数据的数据库交互。To learn more about connecting to your MongoDB instance and loading a sample dataset, see the Usage Examples guide.要了解有关连接到MongoDB实例并加载示例数据集的更多信息，请参阅用法示例指南。

import { MongoClient } from "mongodb";


// Replace the uri string with your MongoDB deployment's connection string.用MongoDB部署的连接字符串替换uri字符串。
const uri = "<connection string uri>";


const client = new MongoClient(uri);


async function  run() {
  try {
    await client.connect();


    const database = client.db("sample_mflix");
    const movies = database.collection("movies");


    // Query for a movie that has title "Annie Hall"
    const query = { title: "Annie Hall" };


    const result = await movies.deleteOne(query);
    if (result.deletedCount === 1) {
      console.log("Successfully deleted one document.");
    } else {
      console.log("No documents matched the query. Deleted 0 documents.");
    }
  } finally {
    await client.close();
  }
}
run().catch(console.dir);
import { MongoClient } from "mongodb";


// Replace the uri string with your MongoDB deployment's connection string.用MongoDB部署的连接字符串替换uri字符串。
const uri = "<connection string uri>";


const client = new MongoClient(uri);


async function  run() {
  try {
    await client.connect();


    const database = client.db("sample_mflix");
    const movies = database.collection("movies");


    // Query for a movie that has title "Annie Hall"
    const query = { title: "Annie Hall" };


    const result = await movies.deleteOne(query);
    if (result.deletedCount === 1) {
      console.log("Successfully deleted one document.");
    } else {
      console.log("No documents matched the query. Deleted 0 documents.");
    }
  } finally {
    await client.close();
  }
}
run().catch(console.dir);
Note
Identical Code Snippets相同的代码片段

The JavaScript and TypeScript code snippets above are identical. 上面的JavaScript和TypeScript代码片段是相同的。There are no TypeScript specific features of the driver relevant to this use case.驱动程序没有与此用例相关的特定于TypeScript的特性。

If you run the preceding example, you should see the following output:如果运行前面的示例，您应该会看到以下输出：

Successfully deleted one document.

On subsequent runs of the preceding example, as you already deleted the document that matched your query, you should see the following output:在前面示例的后续运行中，由于您已经删除了与查询匹配的文档，您应该会看到以下输出：

No documents matched the query. Deleted 0 documents.