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 de exemplos de uso.
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.