Página inicial do Docs → Desenvolver aplicações → MongoDB Drivers → Controlador Node.js
Encontrar um documento
Você pode fazer query em um único documento em uma coleção com o método collection.findOne(). O método findOne() utiliza um documento de query fornecido por você para corresponder somente ao subconjunto de documentos da coleção que correspondem à query. Se você não fornecer um documento de query ou se fornecer um documento vazio, o MongoDB corresponderá a todos os documentos na coleção. A operação findOne() retorna apenas o primeiro documento correspondente. Para obter mais informações sobre query do MongoDB, consulte nossa documentação sobre documentos de query.
Você também pode definir mais opções de query, como classificação e projeção, para configurar o documento retornado. Você pode especificar mais opções no options objeto passado como o segundo parâmetro do findOne método . Para obter documentação de referência detalhada, consulte collection.findOne().
Compatibilidade
Você pode utilizar o driver Node.js para conectar e utilizar o método findOne() para implantações hospedadas nos seguintes ambientes:
MongoDB Atlas: o serviço totalmente gerenciado para implantações MongoDB na nuvem
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: A versão do MongoDB com fonte disponível, de uso gratuito e autogerenciada
Para saber mais sobre como localizar documentos na interface de usuário do Atlas para implantações hospedadas no MongoDB Atlas, consulte Criar, Visualizar, Atualizar e Excluir Documentos.
Exemplo
O trecho a seguir encontra um único documento da coleção movies. Ele usa os seguintes parâmetros:
Um documento de query que configura a query para retornar apenas filmes com o título exatamente do texto
'The Room'.Uma classificação que organiza os documentos correspondentes em ordem decrescente por classificação. Portanto, se nossa query corresponder a vários documentos, o documento devolvido será o documento com a classificação mais alta.
Uma projeção que exclui explicitamente o campo
_iddos documentos retornados e inclui explicitamente somente o objetotitleeimdb(e seus campos embutidos).
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.
Executando o exemplo anterior, você visualiza a seguinte saída:
{ title: 'The Room', imdb: { rating: 3.5, votes: 25673, id: 368226 } }