Menu Docs
Página inicial do Docs
/ / /
Node.js
/ /

Excluir um documento

Você pode excluir um único documento em uma coleção com collection.deleteOne(). O método deleteOne() utiliza um documento de query fornecido por você para corresponder ao subconjunto de documentos da coleção que correspondem à query. Se você não fornecer um query documento (ou se fornecer um documento vazio), o MongoDB corresponderá a todos os documentos da coleção e excluirá a primeira correspondência.

Você pode especificar opções de consulta adicionais utilizando o objeto options passado como o segundo parâmetro do método deleteOne. Para obter mais informações sobre esse método, consulte a documentação da API deleteOne().

Observação

Se o seu aplicativo precisar do documento excluído após a exclusão, considere o uso do método collection.findOneAndDelete() , que tem uma interface semelhante a deleteOne(), mas também retorna o documento excluído.

O trecho a seguir exclui um único documento da coleção movies. Ele usa um query que configura a query para corresponder a filmes com um valor title de "Annie Hall".

Observação

Você pode utilizar este exemplo para se conectar a uma instância do MongoDB e interagir com um banco de dados que contém dados de amostra. Para saber mais sobre como se conectar à sua instância do MongoDB e carregar um conjunto de dados de amostra, consulte o guia Exemplos de uso.

1import { MongoClient } from "mongodb";
2
3// Replace the uri string with your MongoDB deployment's connection string.
4const uri = "<connection string uri>";
5
6const client = new MongoClient(uri);
7
8async function run() {
9 try {
10 const database = client.db("sample_mflix");
11 const movies = database.collection("movies");
12
13 // Query for a movie that has title "Annie Hall"
14 const query = { title: "Annie Hall" };
15
16 const result = await movies.deleteOne(query);
17 if (result.deletedCount === 1) {
18 console.log("Successfully deleted one document.");
19 } else {
20 console.log("No documents matched the query. Deleted 0 documents.");
21 }
22 } finally {
23 await client.close();
24 }
25}
26run().catch(console.dir);
1import { MongoClient } from "mongodb";
2
3// Replace the uri string with your MongoDB deployment's connection string.
4const uri = "<connection string uri>";
5
6const client = new MongoClient(uri);
7
8async function run() {
9 try {
10 const database = client.db("sample_mflix");
11 const movies = database.collection("movies");
12
13 // Query for a movie that has title "Annie Hall"
14 const query = { title: "Annie Hall" };
15
16 const result = await movies.deleteOne(query);
17 if (result.deletedCount === 1) {
18 console.log("Successfully deleted one document.");
19 } else {
20 console.log("No documents matched the query. Deleted 0 documents.");
21 }
22 } finally {
23 await client.close();
24 }
25}
26run().catch(console.dir);

Observação

Trechos de código idênticos

Os trechos de código JavaScript e TypeScript acima são idênticos. Não existem características específicas do TypeScript do condutor relevantes para este caso de utilização.

Se você executar o exemplo anterior, verá a seguinte saída:

Successfully deleted one document.

Nas execuções subsequentes do exemplo anterior, como você já excluiu o documento que correspondia à sua query, você verá a seguinte saída:

No documents matched the query. Deleted 0 documents.

Voltar

Excluir operações