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 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.
← Excluir operações