# General Translation React SDKs (gt-react, gt-next): useRegion
URL: https://generaltranslation.com/ru/docs/react/reference/hooks/use-region.mdx
---

title: useRegion
description: Чтение активного региона с помощью General Translation gt-react. Справочник API для useRegion.

---

Хук `useRegion` возвращает текущий регион, выбранный пользователем, из context [`<GTProvider>`](/docs/react/reference/components/gt-provider) или `undefined`, если он не задан.

*Доступно в `gt-react`, `gt-next` и `gt-react-native`. В примерах используется импорт из `gt-react`; вместо этого импортируйте из пакета вашего фреймворка.*

*Примечание: не экспортируется из `gt-tanstack-start`.*

## Обзор [#overview]

Вызовите `useRegion`, чтобы получить код активного региона.

```tsx
import { useRegion } from 'gt-react';

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

*Примечание: в `gt-react` вызывайте `useRegion` внутри [`<GTProvider>`](/docs/react/reference/components/gt-provider). В `gt-next` это также работает в синхронных серверных компонентах.*

## Как это работает [#how-it-works]

Регион задается через компонент [`<RegionSelector>`](/docs/react/reference/components/region-selector) или хук [`useRegionSelector`](/docs/react/reference/hooks/use-region-selector). Если пользователь не выбрал регион, хук возвращает `undefined`.

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

**Тип** `string | undefined`

Код активного региона, например `US` или `CA`, либо `undefined`, если регион не задан.

## Заметки [#notes]

* В асинхронном компоненте App Router вместо этого используйте [`getRegion`](/docs/react/nextjs/reference/functions/get-region).
* Чтобы сменить регион, используйте [`useSetRegion`](/docs/react/reference/hooks/use-set-region) или [`<RegionSelector>`](/docs/react/reference/components/region-selector).