translation-google
translation-google copied to clipboard
A Google Translate component for Nodejs.
translation-google
A Google Translate API: WARNING: There is IP banned risk from Google Translate when you use this way to do translation.
Features
- Translate all languages that Google Translate supports.
- Support different area (Support Chinese user, in China Mainland could set the suffix to
'cn'
to make it work)
Live Demo with Nodejs
Install
npm install translation-google
Usage
From automatic language detection to English:
var translate = require('translation-google');
translate('This is Google Translate', {to: 'zh-cn'}).then(res => {
console.log(res.text);
//=> 这是Google翻译
console.log(res.from.language.iso);
//=> en
}).catch(err => {
console.error(err);
});
For Chinese user, try this:
var translate = require('translation-google');
translate.suffix = 'cn'; // also can be 'fr', 'de' and so on, default is 'com'
translate('This is Google Translate', {to: 'zh-cn'}).then(res => {
console.log(res.text);
//=> 这是Google翻译
console.log(res.from.language.iso);
//=> en
}).catch(err => {
console.error(err);
});
Sometimes, the API will not use the auto corrected text in the translation:
translate('This is Google Translat', {from: 'en', to: 'zh-cn'}).then(res => {
console.log(res);
console.log(res.text);
//=> 这是Google翻译
console.log(res.from.text.autoCorrected);
//=> false
console.log(res.from.text.value);
//=> This is Google [Translate]
console.log(res.from.text.didYouMean);
//=> true
}).catch(err => {
console.error(err);
});
API
translate(text, options)
text
Type: string
The text to be translated
options
Type: object
from
Type: string
Default: auto
The text
language. Must be auto
or one of the codes/names (not case sensitive) contained in languages.js
to
Type: string
Default: en
The language in which the text should be translated. Must be one of the codes/names (not case sensitive) contained in languages.js.
raw
Type: boolean
Default: false
If true
, the returned object will have a raw
property with the raw response (string
) from Google Translate.
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 thetext
-
-
text
(object)-
autoCorrected
(boolean) –true
if the API has auto corrected thetext
-
value
(string) – The auto correctedtext
or thetext
with suggested corrections -
didYouMean
(booelan) –true
if the API has suggested corrections to thetext
-
-
-
raw
(string) - Ifoptions.raw
is true, the raw response from Google Translate servers. Otherwise,''
.
Note that res.from.text
will only be returned if from.text.autoCorrected
or from.text.didYouMean
equals to true
. In this case, it will have the corrections delimited with brackets ([ ]
):
translate('This is Google Translat').then(res => {
console.log(res.from.text.value);
//=> This is [Google Translate]
}).catch(err => {
console.error(err);
});
Otherwise, it will be an empty string
(''
).
License
MIT