# General Translation Platform: FileToTranslate (legacy)
URL: https://generaltranslation.com/ru/docs/platform/core/reference/types/file-to-translate.mdx
---

title: FileToTranslate (legacy)
description: Ознакомьтесь с устаревшим параметром файла, удалённым из Core v9, и его актуальной заменой. Справочник API для FileToTranslate.

---

`FileToTranslate` представлял собой объект файла в пакетных процессах перевода Core 8.x. Он не экспортируется из `generaltranslation` 9.x.

<Callout type="info">
  **Изменено в v9:** `FileToTranslate` был удалён. Используйте `FileToUpload` с [`uploadSourceFiles`](/docs/platform/core/reference/gt-class-methods/translation/upload-source-files), а затем передайте возвращённые ссылки на файлы в [`enqueueFiles`](/docs/platform/core/reference/gt-class-methods/translation/enqueue-files).
</Callout>

## Обзор [#overview]

Устаревший тип объединял содержимое файла в исходном виде, его имя и формат:

```typescript
type FileToTranslate = {
  content: string;
  fileName: string;
  fileFormat: FileFormat;
  formatMetadata?: Record<string, any>;
  dataFormat?: DataFormat;
};
```

## Свойства [#properties]

| Свойство                             | Описание                                | Тип                                                             | Необязательно |
| ------------------------------------ | --------------------------------------- | --------------------------------------------------------------- | ------------- |
| [`content`](#content)                | Содержимое файла в исходном виде.       | `string`                                                        | Нет           |
| [`fileName`](#file-name)             | Идентификатор файла.                    | `string`                                                        | Нет           |
| [`fileFormat`](#file-format)         | Устаревший идентификатор формата файла. | строковое объединение                                           | Нет           |
| [`formatMetadata`](#format-metadata) | Метаданные для конкретного формата.     | `Record<string, any>`                                           | Да            |
| [`dataFormat`](#data-format)         | Формат данных внутри файла.             | [`DataFormat`](/docs/platform/core/reference/types/data-format) | Да            |

### `content` [#content]

**Тип** `string` · **Обязательно**

Содержимое файла в исходном виде.

### `fileName` [#file-name]

**Тип** `string` · **Обязательно**

Идентификатор файла, например `common.json` или `docs/start.mdx`.

### `fileFormat` [#file-format]

**Тип** строковое объединение · **Обязательно**

Устаревший идентификатор формата файла, например `'JSON'`, `'PO'`, `'MDX'` или `'HTML'`.

### `formatMetadata` [#format-metadata]

**Тип** `Record<string, any>` · **Необязательно**

Метаданные для конкретного формата.

### `dataFormat` [#data-format]

**Тип** [`DataFormat`](/docs/platform/core/reference/types/data-format) · **Необязательно**

Формат данных в файле: `'JSX'`, `'ICU'` или `'I18NEXT'`.

## Устаревший пример [#legacy-example]

```typescript
// только generaltranslation 8.x
import type { FileToTranslate } from 'generaltranslation';

// JSON-файл
const jsonFile: FileToTranslate = {
  content: JSON.stringify({
    "welcome": "Welcome",
    "save": "Save"
  }),
  fileName: 'common.json',
  fileFormat: 'JSON',
  dataFormat: 'I18NEXT'
};
```

```typescript
// MDX-файл
const mdxFile: FileToTranslate = {
  content: `# Getting Started\n\nWelcome to our platform!`,
  fileName: 'docs/start.mdx',
  fileFormat: 'MDX',
  dataFormat: 'JSX'
};
```

## Текущая замена [#replacement]

В версии 9.x импортируйте `FileToUpload` из `generaltranslation/types`, загрузите исходный файл и используйте полученную ссылку в последующих операциях:

```typescript
import { GT } from 'generaltranslation';
import type { FileToUpload } from 'generaltranslation/types';

const gt = new GT({
  apiKey: process.env.GT_API_KEY,
  projectId: process.env.GT_PROJECT_ID,
});

const source = {
  content: JSON.stringify({ welcome: 'Welcome' }),
  fileName: 'common.json',
  fileFormat: 'JSON',
  locale: 'en',
} satisfies FileToUpload;

const { uploadedFiles } = await gt.uploadSourceFiles(
  [{ source }],
  { sourceLocale: 'en' }
);
```