googletrans

> Free and Unlimited Google translate API for node.js


Features

- Fast and reliable
- Batch translation
- Auto language detection
- Spelling correction
- HTTP/2 support
- Connection pooling

Installing

Using npm

``bash
npm i -S googletrans
`

Using yarn

`bash
yarn add googletrans
`

Using pnpm

`bash
pnpm add googletrans
`

CommonJS usage

To gain the TypeScript typings (for intellisense / autocomplete) while using CommonJS imports with require() use the following approach:

`javascript
const tr = require("googletrans").default;
`

Super simple to use

$3

`javascript
const tr = require("googletrans").default;

// Promise
tr("hola")
.then(function (result) {
console.log(result.text); // hello
console.log(result.src); // fr
})
.catch(function (error) {
console.log(error);
});

// Want to use async/await？
async function translation() {
try {
const result = await tr("vue");
console.log(result.text); // view
console.log(result.src); // fr
} catch (error) {
console.log(error);
}
}
`

$3

An array can be used to translate a batch of texts.

`javascript
// eo => en
tr(["Saluton", "Mondo"])
.then(function (result) {
console.log(result.textArray); // [ 'Hello', 'world' ]
console.log(result.src); // eo
})
.catch(function (error) {
console.log(error);
});

// en => de
tr(["Hello", "world"], "de")
.then(function (result) {
console.log(result.textArray); // [ 'Hallo', 'Welt' ]
console.log(result.src); // en
})
.catch(function (error) {
console.log(error);
});
`

> NOTE: The first element of the text array can not empty string.

$3

If the API suggests a correction text, hasCorrectedText will equals to true.

In this case, correction text will have the corrections delimited with brackets ([ ]), correctedText is the crrection text.

`javascript
// en => nl
tr("I spea English", "nl")
.then(function (result) {
console.log(result.text); // ik spreek Engels
console.log(result.hasCorrectedText); // true
console.log(result.correctedText); // I [speak] English
console.log(result.src); // en
})
.catch(function (error) {
console.log(error);
});
`

$3

- from The source language you want to translate. (Default: auto)
- to The language you want to translate into.(Default: en)
- tld The google translate domain name. In this case, tld:"co.jp"it will be uses translate.google.co.jp

`javascript
// en => ja
tr("Hello", { from: "en", to: "ja", tld: "co.jp" })
.then(function (result) {
console.log(result.text); // こんにちは
console.log(result.src); // en
})
.catch(function (error) {
console.log(error);
});
`

$3

If the source language is not right, hasCorrectedLang will equal to true.

`javascript
tr("Hero", { from: "pt", to: "nl" })
.then(function (res) {
console.log(res.hasCorrectedLang); // true
console.log(res.src); // en
})
.catch(function (err) {
console.log(err);
});
`

Languages support

The support languages. You can use the short name or the full name.

`javascript
// short name
tr("koa", "en")
.then(function (result) {
console.log(result.text); // also
console.log(result.src); // mg
})
.catch(function (error) {
console.log(error);
});

// full name
tr("koa", "English")
.then(function (result) {
console.log(result.text); // also
console.log(result.src); // mg
})
.catch(function (error) {
console.log(error);
});
`

TypeScript

googletrans includes TypeScript definitions.

`javascript
import tr from "googletrans";
`

Method

`
const tr = require("googletrans").default;
tr(text, options)
`

$3

- text - The text to be translated.
- options - The translation options. If the param is string, mean the language you want to translate into.If the param is object, it can set more options.

$3

`javascript
// string
"en";

// object
{
// The language you want to translate into.(Default: en)
to: "en";
// The source language you want to translate. (Default: auto)
from: "fr";
// The google translate domain name
tld: "co.jp";
}
`

$3

The result of a request contains the following information.

`javascript
Result {
// the translated text.
text: string;

// array of the translated text.
textArray: string[];

// pronunciation
pronunciation: string;

// has correct source language?
hasCorrectedLang: boolean;

// source language
src: string;

// has correct source text?
hasCorrectedText: boolean;

// correct source text
correctedText: string;

// multiple translations
translations: [];

// the raw response from Google Translate servers.
raw: [];
}
``

NOTE

DISCLAIMER: this is an unofficial library using the web API of Google Translate and also is not associated with Google.

- The maximum character limit on a single text is 15k.
- Due to limitations of the web version of google translate, this API does not guarantee that the library would work properly at all times (so please use this library if you don't care about stability).
- If you want to use a stable API, I highly recommend you to use Google's official translate API.

License

MIT

Copyright (c) 2020-present, DarinRowe.