# gt-next: General Translation Next.js SDK: getRegion
URL: https://generaltranslation.com/fr/docs/next/api/helpers/get-region.mdx
---
title: getRegion
description: Référence API de la méthode getRegion côté serveur
---

## Aperçu

La fonction `getRegion` récupère le code de région actuel de l'utilisateur depuis le cookie de région intégré lors du rendu côté serveur.

<Callout>
  `getRegion` est une méthode côté serveur et ne peut être utilisée que dans les composants serveur.
</Callout>

Pour une utilisation côté client, consultez [`useRegion`](/docs/next/api/helpers/use-region).

## Référence

### Renvoie

`Promise<string | undefined>` — Une promesse qui se résout avec le code de région de l’utilisateur (par ex. `"US"`, `"CA"`), ou `undefined` si aucune région n’a été définie.

***

## Exemples

### Utilisation de base

```jsx title="RegionDisplay.jsx" copy
import { getRegion } from 'gt-next/server';

export default async function RegionDisplay() {
  const region = await getRegion(); // [!code highlight]
  return <p>Current region: {region ?? 'Not set'}</p>;
}
```

***


## Remarques

* `getRegion` est asynchrone et doit être utilisé avec `await`.
* Renvoie `undefined` si l’utilisateur n’a pas sélectionné de région.
* La région est stockée dans un cookie et peut être définie à l’aide du composant [`<RegionSelector>`](/docs/next/api/components/region-selector) ou du hook [`useRegionSelector`](/docs/next/api/helpers/use-region-selector).

## Prochaines étapes

* Consultez [`useRegion`](/docs/next/api/helpers/use-region) pour l’équivalent côté client.
* Utilisez [`<RegionSelector>`](/docs/next/api/components/region-selector) pour permettre aux utilisateurs de choisir leur région.