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.
Exemplo
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.
1 import { MongoClient } from "mongodb"; 2 3 // Replace the uri string with your MongoDB deployment's connection string. 4 const uri = "<connection string uri>"; 5 6 const client = new MongoClient(uri); 7 8 async 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 } 26 run().catch(console.dir);
1 import { MongoClient } from "mongodb"; 2 3 // Replace the uri string with your MongoDB deployment's connection string. 4 const uri = "<connection string uri>"; 5 6 const client = new MongoClient(uri); 7 8 async 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 } 26 run().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.