# translatte
> A free and unlimited translate for NodeJS
Latest version **3.0.1** (published 2021-06-20) · MIT license · 0 weekly downloads
## Install
```sh
npm install translatte
pnpm add translatte
yarn add translatte
bun add translatte
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 3.0.1 |
| Published | 2021-06-20 |
| First published | 2018-09-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 630.7 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 95 |
| Author | ExtensionsApp |
| Maintainers | extensionsapp |
| Keywords | translate, translator, google, google translate, api, free, language, proxy, translatte, microsoft, azure, microsoft azure, microsoft translate, azure translate, google cloud, google cloud translate, yandex, yandex cloud, yandex translate, yandex cloud translate |
## Links
- npm: https://www.npmjs.com/package/translatte
- Repository: https://github.com/extensionsapp/translatte
- Homepage: https://github.com/extensionsapp/translatte#readme
- Issues: https://github.com/extensionsapp/translatte/issues
- npm.io page: https://npm.io/package/translatte
## Dependencies (4)
- [got](https://npm.io/package/got.md) 9.6.0
- [tunnel](https://npm.io/package/tunnel.md) 0.0.6
- [configstore](https://npm.io/package/configstore.md) 4.0.0
- [proxy-check](https://npm.io/package/proxy-check.md) 1.0.8
## Alternatives
- [ext-list](https://npm.io/package/ext-list.md) — 6.3M weekly downloads
- [@lexical/selection](https://npm.io/package/@lexical/selection.md) — 3.8M weekly downloads
- [@lexical/text](https://npm.io/package/@lexical/text.md) — 3.6M weekly downloads
- [@lexical/clipboard](https://npm.io/package/@lexical/clipboard.md) — 3.0M weekly downloads
- [@tiptap/extension-mention](https://npm.io/package/@tiptap/extension-mention.md) — 3.0M weekly downloads
## Recent versions
- 3.0.1 (latest) — 2021-06-20
- 3.0.0 — 2020-10-12
- 2.5.8 — 2020-05-12
- 2.5.7 — 2020-05-12
- 2.5.6 — 2020-01-25
- 2.5.5 — 2019-07-22
- 2.5.4 — 2019-07-17
- 2.4.4 — 2019-07-14
- 2.4.3 — 2019-07-04
- 2.3.3 — 2019-07-03
- 2.2.3 — 2019-07-03
- 2.2.2 — 2019-07-03
- 2.1.2 — 2019-06-19
- 2.1.1 — 2019-06-16
- 2.1.0 — 2019-06-10
- … 7 more at https://npm.io/package/translatte/versions
## README
# A free and unlimited translate for NodeJS.
### Installation
```
npm i translatte
```
### Usage
Translate string to German:
```javascript
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:
```javascript
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:PASSWORD@192.0.2.100:12345',
'LOGIN:PASSWORD@192.0.2.200: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](https://github.com/extensionsapp/translatte/blob/master/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](https://github.com/extensionsapp/translatte/blob/master/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:PASSWORD@192.0.2.100:12345', 'LOGIN:PASSWORD@192.0.2.200: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 language
- `iso` *(string)* - The [code of the language](https://github.com/extensionsapp/translatte/blob/master/languages.js) 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, `''`.
- `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 (`[ ]`):
``` js
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`.
```json
{
"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:PASSWORD@192.0.2.100:12345` is inactive.
```json
{
"google_free": "LOGIN:PASSWORD@192.0.2.100:12345"
}
```
If the error is not related to `services`.
```json
{
"message": "The language «foo» is not supported"
}
```
**2020 ExtensionsApp**
---
_Source: https://npm.io/package/translatte · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._