免费的 DeepL 网页版翻译 API（非官方）。使用 Playwright 启动本地浏览器，自动打开 DeepL 网页完成翻译。
适用于 Node.js 环境，支持自动检测源语言，仅需指定目标语言。目标语言代码完全遵循 DeepL 官方.
pnpm add deepl-translate-api
# 或
npm i deepl-translate-api
# 或
yarn add deepl-translate-api首次运行若未安装浏览器，工具将引导安装 Playwright 的 Chromium。
import { translate } from "deepl-translate-api";
const res = await translate("Hello world", "ZH-HANS");
console.log(res.data); // 你好，世界| 方法 | 签名 | 返回 | 说明 |
|---|---|---|---|
| translate | translate(text, targetLang?) |
Promise<TranslateResult> |
执行一次翻译，自动检测源语言，仅需指定目标语言 |
| cleanup | cleanup() |
Promise<void> |
关闭并释放浏览器实例与页面资源 |
| findChromePath | findChromePath() |
`string | null` |
| askUserToDownloadChrome | askUserToDownloadChrome() |
Promise<boolean> |
交互式询问是否自动安装 Playwright 的 Chromium |
| launchWithPlaywrightChromium | launchWithPlaywrightChromium() |
Promise<{ browser, page }> |
使用 Playwright 内置 Chromium 启动并返回浏览器与页面 |
| getSupportedLanguages | getSupportedLanguages() |
string[] |
返回 DeepL 官方目标语言代码（大写）列表 |
translate 参数：
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| text | string |
是 | - | 需要翻译的文本，最大 5000 字符 |
| targetLang | string |
否 | "ZH-HANS" |
DeepL 官方目标语言代码，如 EN-US、EN-GB、ZH-HANS、ZH-HANT
|
完全使用 DeepL 官方语言代码（大写）：
AR, BG, CS, DA, DE, EL, EN, EN-GB, EN-US, ES, ET, FI, FR, HE, HU, ID, IT,
JA, KO, LT, LV, NB, NL, PL, PT, PT-BR, PT-PT, RO, RU, SK, SL, SV, TH, TR,
UK, VI, ZH, ZH-HANS, ZH-HANT
中文建议：ZH-HANS（简体）、ZH-HANT（繁体）。英语建议：EN-GB（英式）、EN-US（美式）。
- 仅限服务端/本地 Node.js 环境，不适用于浏览器端。
- DeepL 网页版存在速率限制，频繁请求可能被限制；遇到 Too Many Requests 请降低频率或稍后再试。
- 首次运行如未安装 Chromium，将自动执行安装；也可手动运行：
npx playwright install chromium。
- 无法找到 Chrome：将提示自动安装 Chromium，或手动安装系统 Chrome 后重试。
- 结果为空：会自动截图到当前目录
error_screenshot_*.png以便排查。 - 进程未退出：调用
cleanup()释放浏览器资源。
MIT