# node: getGT
URL: https://generaltranslation.com/ru/docs/node/api/get-gt.mdx
---
title: getGT
description: Справочник по API функции getGT для перевода строк
---

## Обзор

Функция `getGT` — это асинхронная функция, которая возвращает функцию перевода строк.
Она находит переводы, зарегистрированные компилятором GT на этапе сборки.

```js
import { getGT } from 'gt-node';

const gt = await getGT();
const greeting = gt('Hello, world!');
```

<Callout>
  **Требуется контекст запроса:**
  `getGT` должен вызываться внутри колбэка [`withGT`](/docs/node/api/with-gt), чтобы понимать, какую локаль использовать.
</Callout>


## Справочник

### Параметры

Отсутствуют.

### Возвращает

Промис, результатом которого является функция перевода `gt`:

```ts
Promise<(content: string, options?: InlineTranslationOptions) => string>
```

| Название   | Тип                        | Описание                                                          |
| ---------- | -------------------------- | ----------------------------------------------------------------- |
| `content`  | `string`                   | Строка, которую нужно перевести.                                  |
| `options?` | `InlineTranslationOptions` | Необязательные параметры перевода (переменные, контекст и т. д.). |

Функция `gt` возвращает переведённую строку или исходную, если перевод не найден.


#### `InlineTranslationOptions`

| Свойство     | Тип      | Описание                                                                          |
| ------------ | -------- | --------------------------------------------------------------------------------- |
| `$context?`  | `string` | Дополнительный контекст, помогающий снять неоднозначность перевода.               |
| `$id?`       | `string` | Пользовательский идентификатор для записи перевода.                               |
| `$maxChars?` | `number` | Максимальное число символов в переводе.                                           |
| Другие ключи | `any`    | Значения переменных для подстановки в строку с использованием синтаксиса `{key}`. |

***

## Примеры

### Простой перевод

```js title="handler.js"
import { withGT, getGT } from 'gt-node';

function handleRequest(locale: string) {
  return withGT(locale, async () => {
    const gt = await getGT();
    return gt('Hello, world!');
  });
}
```


### С переменными

Используйте синтаксис `{variableName}` в строке и передавайте значения через объект options:

```js title="handler.js"
import { withGT, getGT } from 'gt-node';

function handleGreeting(locale: string, name: string) {
  return withGT(locale, async () => {
    const gt = await getGT();
    return gt('Hello, {name}!', { name });
  });
}
```


### С форматом сообщений ICU

`gt-node` поддерживает формат сообщений ICU для более сложного форматирования:

```js title="handler.js"
const gt = await getGT();
const balance = gt(
  'Your balance: {amount, number, ::currency/USD}',
  { amount: 1234.56 }
);
```

***


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

* `getGT` возвращает функцию перевода, работающую **на этапе сборки**. Строки переводятся в процессе CD до развертывания.
* В режиме разработки переводы выполняются по запросу (требуется Dev API key).
* Если перевод не найден, возвращается исходная строка в качестве резервного варианта.

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

* См. [`getMessages`](/docs/node/api/get-messages), чтобы получать предварительно зарегистрированные сообщения.
* См. [`withGT`](/docs/node/api/with-gt), чтобы настроить контекст локали.