@34r7h/google-translate-api 中文文档教程

Question

google-translate-api

Google 翻译的免费和无限制 API :dollar::no< em>入口标志：用于 Node.js。

Features

• Auto language detection
• Spelling correction
• Language correction
• Fast and reliable – it uses the same servers that translate.google.com uses

Why this fork?

这个原始 matheuss/google-translate-api 的分支包含几项改进：

• New option client="t|gtx". Setting client="gtx" seems to work even with outdated token, see this discussion for details
• Fixed extraction of TKK ceed from current https://translate.google.com sources (via @vitalets/google-translate-token)
• Removed unsecure unsafe-eval dependency (See #2)
• Added daily CI tests to get notified if Google API changes
• Added support for custom tld (especially to support translate.google.cn, see #7)
• Added support for outputting pronunciation (see #17)
• Added support for custom got options. It allows to use proxy and bypass request limits (see #25)
• Added support for language extensions from outside of the API (See #18)

Install

npm install @vitalets/google-translate-api

Usage

从自动语言检测到英语：

const translate = require('@vitalets/google-translate-api');

translate('Ik spreek Engels', {to: 'en'}).then(res => {
    console.log(res.text);
    //=> I speak English
    console.log(res.from.language.iso);
    //=> nl
}).catch(err => {
    console.error(err);
});

从英语荷兰语拼写错误：

translate('I spea Dutch!', {from: 'en', to: 'nl'}).then(res => {
    console.log(res.text);
    //=> Ik spreek Nederlands!
    console.log(res.from.text.autoCorrected);
    //=> true
    console.log(res.from.text.value);
    //=> I [speak] Dutch!
    console.log(res.from.text.didYouMean);
    //=> false
}).catch(err => {
    console.error(err);
});

有时，API 不会在翻译中使用自动更正的文本：

translate('I spea Dutch!', {from: 'en', to: 'nl'}).then(res => {
    console.log(res);
    console.log(res.text);
    //=> Ik spea Nederlands!
    console.log(res.from.text.autoCorrected);
    //=> false
    console.log(res.from.text.value);
    //=> I [speak] Dutch!
    console.log(res.from.text.didYouMean);
    //=> true
}).catch(err => {
    console.error(err);
});

您还可以在代码中添加语言并在翻译中使用它们：

translate = require('google-translate-api');
translate.languages['sr-Latn'] = 'Serbian Latin';

translate('translator', {to: 'sr-Latn'}).then(res => ...);

Proxy

谷歌翻译有请求限制。 如果发出的请求太多，您可能会以 429 或 503 错误结束。 您可以使用代理 来绕过它们：

const tunnel = require('tunnel');
translate('Ik spreek Engels', {to: 'en'}, {
    agent: tunnel.httpsOverHttp({
    proxy: { 
      host: 'whateverhost',
      proxyAuth: 'user:pass',
      port: '8080',
      headers: {
        'User-Agent': 'Node'
      }
    }
  }
)}).then(res => {
    // do something
}).catch(err => {
    console.error(err);
});

Does it work from web page context?

不。https://translate.google.com 不提供 CORS 允许从其他域访问的 http 标头。

API

translate(text, [options], [gotOptions])

text

类型：string

要翻译的文本

options

类型：object

from

类型：string 默认值：auto

文本 语言。 必须是 auto 或包含在 languages.js

to

类型：string 默认值：en

文本应翻译成的语言。 必须是 languages.js。

raw

类型：boolean 默认值：false

如果 true，返回的对象将有一个 raw 属性，原始响应 ( string) 来自谷歌翻译。

client

类型：string 默认值："t"

API 调用中使用的查询参数 client。 可以是 t|gtx。

tld

类型：string 默认值：“com”

在 API 调用中使用的 Google 翻译主机的 TLD：https://translate.google.{tld}代码>。

gotOptions

类型：object

得到的选项：https://github.com/sindresorhus/got#options

Returns an object:

• text (string) – The translated text.
• from (object)
• language (object)
  • didYouMean (boolean) - true if the API suggest a correction in the source language
  • iso (string) - The code of the language that the API has recognized in the text
• text (object)
  • autoCorrected (boolean) – true if the API has auto corrected the text
  • value (string) – The auto corrected text or the text with suggested corrections
  • didYouMean (boolean) – true if the API has suggested corrections to the text
• raw (string) - If options.raw is true, the raw response from Google Translate servers. Otherwise, ''.

注意 res.from.text 只有在 from .text.autoCorrected 或 from.text.didYouMean 等于 true。 在这种情况下，它将用方括号 ([ ]) 分隔更正：

translate('I spea Dutch').then(res => {
    console.log(res.from.text.value);
    //=> I [speak] Dutch
}).catch(err => {
    console.error(err);
});

否则，它将是一个空的 string ('') .

Related

• vertaler – CLI for this module

License

MIT © Matheus Fernandes，由 Vitaliy Potapov 分叉和维护。