Documentação Bando

findMany()

Consulta documentos e recebe os resultados juntamente com o total.

Consultar conteúdo

Depois de criares documentos, a próxima tarefa é buscá-los na tua aplicação.

O Bando permite combinar filtros, paginação e ordenação numa única consulta.

Um exemplo real

Imagina que queremos os 10 posts publicados mais recentemente:

TS
const { data, total } =
await bando.collection<Post>("posts").findMany({
limit: 10,
offset: 0,
sort: "-createdAt",
filters: {
published: true,
},
});

O que recebemos?

O resultado possui duas informações importantes:

TS
const { data, total } = result;

data contém os documentos encontrados.

total informa o total de documentos que correspondem à consulta, permitindo construir paginação na interface.

Paginação

limit define quantos documentos queremos receber.offset define quantos documentos devem ser ignorados antes de começar a devolver resultados.

Por exemplo, para buscar os primeiros 10:

TS
{
limit: 10,
offset: 0,
}

Para buscar os próximos 10:

TS
{
limit: 10,
offset: 10,
}

Ordenação

A ordenação aceita id, createdAt eupdatedAt.

Um - antes do campo significa ordem descendente:

TS
sort: "-createdAt"

Filtros

Os filtros atuais usam igualdade.

TS
filters: {
published: true,
}

Isso procura documentos cujo campo published seja verdadeiro.

ParâmetroTipoObrigatórioPor omissãoDescrição
limitintegernãoNúmero máximo de documentos devolvidos. Deve ser um inteiro não negativo.
offsetintegernão0Número de documentos ignorados antes de começar a devolver resultados.
sortstringnão-createdAtCampo usado para ordenar os resultados. Aceita id, createdAt ou updatedAt. O prefixo - indica ordem descendente.
fieldstringnãoFiltro por igualdade. Por exemplo, published=true procura documentos cujo campo published seja verdadeiro.
Aprender mutações →
Conhecer o cliente TypeScript →
findMany() | Bando