# gt-node: General Translation Node.js SDK: getVersionId
URL: https://generaltranslation.com/zh/docs/node/reference/functions/get-version-id.mdx
---

title: getVersionId
description: 读取 General Translation gt-node 中配置的翻译版本 ID。getVersionId 的 API 参考。

---

返回为翻译缓存配置的翻译版本 ID (如果已设置) 。该版本 ID 用于固定 `gt-node` 加载的已发布翻译版本。

## 概览 [#overview]

调用 `getVersionId` 且不传任何参数，即可读取当前的版本 ID。若未配置版本 ID，则返回 `undefined`。

```ts
import { getVersionId } from 'gt-node';

const versionId = getVersionId();
console.log(versionId); // 'abc123' 或 undefined
```

签名：

```ts
getVersionId(): string | undefined
```

*注意：版本 ID 是内部缓存设置项。`getVersionId` 只是读取它，不会设置它。*

## 工作原理 [#how-it-works]

* **读取缓存配置。** 它会返回在 [`initializeGT`](/docs/node/reference/functions/initialize-gt) 期间创建的翻译缓存中保存的版本 ID。
* **同步。** 它会立即返回，无需使用 `await`。

## 参数 [#parameters]

`getVersionId` 无需传入参数。

## 返回值 [#returns]

**类型** `string | undefined`

已配置的版本 ID；若未设置，则为 `undefined`。

## 示例 [#examples]

```ts title="handler.js"
import { getVersionId } from 'gt-node';

app.get('/api/version', (req, res) => {
  res.json({ versionId: getVersionId() ?? null });
});
```