limit() (Limitar Contagem de Resultados)
Última atualização: 2026-10-09
limit() (Limitar Contagem de Resultados)
limit() limita quantos documentos find() retorna: `db.users.find({ age: { $gt: 20 } }).limit(5)`. Ele encadeia no cursor e é a ferramenta padrão para paginação e consultas top-N. limit(0) significa sem limite; ele compõe livremente com outros métodos de cursor, ex.: skip() para paginar.
| Categoria | Cursor |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
db.<collection>.find(<filter>).limit(<count>)⚙️ Parâmetros
| quantidade | Número máximo de documentos a retornar; 0 significa ilimitado. |
|---|
Retorno：O cursor com o limite aplicado (encadeável).
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// limit: pega apenas os 3 primeiros adultos
const top3 = db.users.find({ age: { $gte: 18 } }).limit(3).toArray()
top3Saída：
[
{ _id: ObjectId('64c8a1b20000000000000001'), name: 'Alice', age: 21 },
{ _id: ObjectId('64c8a1b20000000000000002'), name: 'Bob', age: 25 }
]📌 Notas
- limit() trunca no servidor; combinado com skip() não é um paginador globalmente consistente
- limit(0) significa ilimitado
- Combine com sort para previsibilidade, ex.: .sort({age: 1}).limit(5)
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QComo limit e skip se combinam para paginação?
APadrão típico: .skip(pageSize*page).limit(pageSize), ex.: .skip(10).limit(10) para a página dois de dez.
QO que significa limit(0)?
Alimit(0) não aplica limite, equivalente a omiti-lo.
QPosso encadear mais métodos de cursor depois de limit?
ASim — limit() retorna um cursor, então sort(), skip(), toArray(), etc. podem vir em seguida.
