---
createdAt: 2024-08-11
updatedAt: 2025-06-29
title: Documentation de la fonction getEnumeration | intlayer
description: Découvrez comment utiliser la fonction getEnumeration pour le package intlayer
keywords:
  - getEnumeration
  - traduction
  - Intlayer
  - intlayer
  - Internationalisation
  - Documentation
  - Next.js
  - JavaScript
  - React
slugs:
  - doc
  - packages
  - intlayer
  - getEnumeration
history:
  - version: 5.5.10
    date: 2025-06-29
    changes: "Historique initial"
---

# Documentation : Fonction `getEnumeration` dans `intlayer`

## Description

La fonction `getEnumeration` récupère le contenu correspondant à une quantité spécifique en fonction de conditions prédéfinies dans un objet d'énumération. Les conditions sont définies comme des clés, et leur priorité est déterminée par leur ordre dans l'objet.

## Paramètres

- `enumerationContent: QuantityContent<Content>`
  - **Description** : Un objet où les clés représentent des conditions (par exemple, `<=`, `<`, `>=`, `=`) et les valeurs représentent le contenu correspondant. L'ordre des clés définit leur priorité de correspondance.
  - **Type** : `QuantityContent<Content>`
    - `Content` peut être de n'importe quel type.

- `quantity: number`
  - **Description** : La valeur numérique utilisée pour faire correspondre les conditions dans `enumerationContent`.
  - **Type** : `number`

## Retour

- **Type** : `Content`
- **Description** : Le contenu correspondant à la première condition correspondante dans `enumerationContent`. Si aucune correspondance n'est trouvée, le comportement par défaut dépend de l'implémentation (par exemple, une erreur ou un contenu de secours).

## Exemple d'utilisation

### Utilisation basique

```typescript codeFormat={["typescript", "esm", "commonjs"]}
import { getEnumeration } from "intlayer";

const content = getEnumeration(
  {
    "<=-2.3": "Vous avez moins de -2.3",
    "<1": "Vous avez moins de un",
    "2": "Vous avez deux",
    ">=3": "Vous avez trois ou plus",
  },
  2
);

console.log(content); // Sortie : "Vous avez deux"
```

### Priorité des conditions

```typescript codeFormat={["typescript", "esm", "commonjs"]}
import { getEnumeration } from "intlayer";

const content = getEnumeration(
  {
    "<4": "Vous avez moins de quatre",
    "2": "Vous avez deux",
  },
  2
);

console.log(content); // Sortie : "Vous avez moins de quatre"
```

## Cas particuliers

- **Aucune condition correspondante :**
  - Si aucune condition ne correspond à la quantité fournie, la fonction retournera soit `undefined`, soit gérera explicitement le scénario par défaut/de secours.

- **Conditions ambiguës :**
  - Si les conditions se chevauchent, la première condition correspondante (selon l'ordre de l'objet) a la priorité.

- **Clés invalides :**
  - La fonction suppose que toutes les clés dans `enumerationContent` sont valides et analysables en tant que conditions. Des clés invalides ou mal formatées peuvent entraîner un comportement inattendu.

- **Application stricte de TypeScript :**
  - La fonction garantit que le type `Content` est cohérent pour toutes les clés, permettant ainsi une sécurité de type lors de la récupération du contenu.

## Notes

- L'utilitaire `findMatchingCondition` est utilisé pour déterminer la condition appropriée en fonction de la quantité donnée.
