translatte
v3.0.1
Published
A free and unlimited translate for NodeJS
Downloads
51,801
Maintainers
Readme
A free and unlimited translate for NodeJS.
Installation
npm i translatte
Usage
Translate string to German:
const translatte = require('translatte');
translatte('Do you speak Russian?', {to: 'de'}).then(res => {
console.log(res.text);
}).catch(err => {
console.error(err);
});
// Ihr sprecht auf Russisch?
Translate string to English using proxy:
const translatte = require('translatte');
translatte('Вы говорите по-русски?', {
from: 'ru',
to: 'en',
agents: [
'Mozilla/5.0 (Windows NT 10.0; ...',
'Mozilla/4.0 (Windows NT 10.0; ...',
'Mozilla/5.0 (Windows NT 10.0; ...'
],
proxies: [
'LOGIN:[email protected]:12345',
'LOGIN:[email protected]:54321'
]
}).then(res => {
console.log(res);
}).catch(err => {
console.error(err);
});
// { text: 'Do you speak Russian?',
// from: {
// language: {
// didYouMean: false,
// iso: 'ru'
// },
// text: {
// autoCorrected: false,
// value: '',
// didYouMean: false
// }
// },
// raw: '' }
API
translatte(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.
agents
Type: array
Default: []
An array
of strings specifying the user-agent ['Mozilla/5.0 ...', 'Mozilla/4.0 ...']
. One random result will be selected.
proxies
Type: array
Default: []
An array
of strings LOGIN:PASSWORD@IP:PORT
specifying the proxies ['LOGIN:[email protected]:12345', 'LOGIN:[email protected]:54321']
. One random result will be selected.
tld
Type: string
Default: com
TLD for Google translate host to be used in API calls: https://translate.google.[tld]
client
Type: string
Default: t
Query parameter client used in API calls. Can be t|gtx
.
priority
Type: array
Default: ['google_free']
Array of priority services.
services
Type: object
Default: {"google_free": true}
Objects in order of priority, if one of the services does not perform the translation, it proceeds to the next.
Supported services:
{"google_free": true}
- Google Translate, this service works by default. It is completely free and has no limits.
{"google_v3": {"project-id": "XXX", "token": "YYY"}}
- Google Cloud, requires registration and credit card details. 500,000 characters per month are issued free of charge, then $20 for every million characters.
{"microsoft_v3": {"key": "XXX", "location": "global"}}
- Microsoft Azure, requires registration and credit card details. Free of charge 2,000,000 characters per month, then $10 for every million characters.
{"yandex_v1": {"key": "XXX"}}
- Yandex Translate, requires registration. Free of charge 10,000,000 characters per month.
{"yandex_v2": {"key": "XXX"}}
- Yandex Cloud, requires registration and credit card details. $15 for every million characters.
Returns an object
:
text
(string) – The translated text.from
(object)language
(object)didYouMean
(boolean) -true
if the API suggest a correction in the source languageiso
(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 correctionsdidYouMean
(boolean) –true
if the API has suggested corrections to thetext
raw
(string) - Ifoptions.raw
is true, the raw response from Google Translate servers. Otherwise,''
.proxy
(string) – The proxy that were used in the request.agent
(string) – The agent that were used in the request.service
(object) – The service that were used in the request.
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('I spea Dutch').then(res => {
console.log(res.from.text.value);
//=> I [speak] Dutch
}).catch(err => {
console.error(err);
});
Otherwise, it will be an empty string
(''
).
Errors an object
:
Errors in the name of each services
.
{
"google_free": "Could not get token from google",
"google_v3": "Response code 403 (Forbidden)",
"microsoft_v3": "Response code 403 (Forbidden)",
"yandex_v1": "Response code 403 (Forbidden)",
"yandex_v2": "Response code 403 (Forbidden)"
}
If the proxy server LOGIN:[email protected]:12345
is inactive.
{
"google_free": "LOGIN:[email protected]:12345"
}
If the error is not related to services
.
{
"message": "The language «foo» is not supported"
}
2020 ExtensionsApp