# gt-next: General Translation Next.js SDK: useRegion
URL: https://generaltranslation.com/ru/docs/next/api/helpers/use-region.mdx
---
title: useRegion
description: Справка по API хука useRegion
---

{/* СОЗДАНО АВТОМАТИЧЕСКИ: Не редактируйте напрямую. Вместо этого измените шаблон в content/docs-templates/. */}


## Обзор

Хук `useRegion` возвращает текущий регион, выбранный пользователем, из [контекста `<GTProvider>`](/docs/next/api/components/gtprovider).

<Callout>
  `useRegion` — это хук для клиентской части и *может использоваться только в клиентских компонентах*.
  Убедитесь, что ваше приложение обёрнуто в [`<GTProvider>`](/docs/next/api/components/gtprovider).
</Callout>

## Справка

### Возвращаемое значение

`string | undefined` — код текущего активного региона (например, `"US"`, `"CA"`), или `undefined`, если регион не задан.

***

## Примеры

### Основы использования

```jsx title="RegionDisplay.jsx" copy
'use client';
import { useRegion } from 'gt-next';

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

***


## Примечания

* Возвращает `undefined`, если пользователь не выбрал регион.
* Регион можно выбрать с помощью компонента [`<RegionSelector>`](/docs/next/api/components/region-selector) или хука [`useRegionSelector`](/docs/next/api/helpers/use-region-selector).

## Следующие шаги

* Используйте [`<RegionSelector>`](/docs/next/api/components/region-selector), чтобы пользователи могли выбрать свой регион.
* Используйте [`useRegionSelector`](/docs/next/api/helpers/use-region-selector), чтобы создать собственный селектор региона.