---
title: La méthode findAll
slug: oip-next/hdu1ofrp5q49hhbs6vlwf
description: Learn how to use the powerful `findAll` method to retrieve a list of entities efficiently. This comprehensive document covers everything, from the flexible filtering options to sorting in the desired order using the `sort` parameter. Explore pagination fu
icon: {"lucideIcon":"📘"}
createdAt: 2023-08-17T15:43:27.000Z
---

# Changelog

:::hint{type="info"}
Les fonctionnalités de tri et de pagination sont disponibles à partir de la version 2.3.0.
:::

# Description

```javascript
const findAll: <E extends { id: string }>(args: {
  query?: Record<string, unknown>;
  sort?: Record<string, 'asc' | 'ascending' | 1 | 'desc' | 'descending' | -1>;
  page?: number;
  pageSize?: number;
}) => E[] | { documents: E[]; page: number; pageSize: number; count: number; nbPages: number };
```

La fonction `findAll` permet de récupérer une liste d'entités de type tableau.

:::hint{type="info"}
La fonction `findAll` est uniquement disponible pour les entités de type tableau.
:::

La fonction `findAll` prend en paramètre :

- `query` : objet permettant d'appliquer un filtrage.
- `sort`: objet permettant d'appliquer un tri.
- `page` : index de la page à récupérer ; le premier index est 0.
- `pageSize` : nombre d'éléments dans une page.

:::hint{type="warning"}
Pour la pagination, les deux paramètres `page` et `pageSize` sont requis.
:::

La fonction `findAll` retourne une liste d'entités filtrées et triées. Dans le cas d'une pagination, le résultat de cette fonction est un objet :

- `documents` : liste d'entités filtrées et triées.
- `page` : index de la page demandée.
- `pageSize` : nombre d'éléments dans une page.
- `count` : nombre total d'éléments correspondant à la requête.
- `nbPages` : nombre total de pages correspondant à la requête.

# Exemples

```javascript
import { Entities } from '@fasstech/oip-core';

// Liste d'entités Project
await Entities('Project').findAll({});

// Liste paginée d'entités Project
await Entities('Project').findAll({ page: 0, pageSize: 5 });

// Liste filtrée, triée et paginée d'entités Project
await Entities('Project').findAll({
  query: { status: 'IN_PROGRESS' },
  sort: { createdAt: 'desc', name: 'asc' },
  page: 0,
  pageSize: 5
});

// Liste d'entités Offer
await Entities('Offer').findAll(project, {});

// Liste paginée d'entités Offer
await Entities('Offer').findAll(project, { page: 0, pageSize: 5 });

// Liste filtrée, triée et paginée d'entités Offer
await Entities('Offer').findAll(project, {
  query: { type: 'HEALTH' },
  sort: { price: -1, name: 'asc' },
  page: 2,
  pageSize: 8
});
```

# Cas particuliers

## Entité StatusHistory

La fonction `findAll` pour l'entité `StatusHistory` autorise uniquement le filtrage. Elle a ainsi une syntaxe différente.

```javascript
await Entities('StatusHistory').findAll(project, { status: 'IN_PROGRESS' });
```
