Security News
The Dark Side of Open Source
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
@vitalets/google-translate-api
Advanced tools
Readme
A free and unlimited API for Google Translate for Node.js.
In version 9+ library was fully rewritten. For legacy documentation please see legacy branch.
DISCLAIMER! To be 100% legal please use official Google Translate API. This project is mainly for pet projects and prototyping.
npm install @vitalets/google-translate-api
import { translate } from '@vitalets/google-translate-api';
const { text } = await translate('Привет, мир! Как дела?', { to: 'en' });
console.log(text) // => 'Hello World! How are you?'
Since react-native has full support of fetch API translation works the same way as in Node.js.
This library does not work inside web pages because translate.google.com
does not provide CORS headers allowing access from other domains.
Although library does not work in regular web pages it can be used in browser extensions. Extensions background and popup pages are not limited with same origin policy. To use translation API you should do the following:
Add host permissions to manifest.json
:
+ "host_permissions": [
+ "https://translate.google.com/"
+ ]
Import translate
as usual in background or popup script:
// background.js
import { translate } from '@vitalets/google-translate-api';
const { text } = await translate('Привет мир');
console.log(text);
Bundle code (for example with webpack
):
// webpack.config.js
module.exports = {
mode: 'development',
entry: './background.js',
output: {
filename: 'bundle.js',
},
};
Google Translate has request limits. If too many requests are made from the same IP address, you will get a TooManyRequestsError (code 429). You can use proxy to bypass it:
import { translate } from '@vitalets/google-translate-api';
import createHttpProxyAgent from 'http-proxy-agent';
const agent = createHttpProxyAgent('http://103.152.112.162:80');
const { text } = await translate('Привет, мир!', {
to: 'en',
fetchOptions: { agent },
});
See [examples/with-proxy.ts] for more details.
Available proxy list you can find here (with
yes
in Google column).
Common pattern for selecting proxy is following:
try {
const { text } = await translate('Привет, мир!', {
to: 'en',
fetchOptions: { agent },
});
} catch (e) {
if (e.name === 'TooManyRequestsError') {
// retry with another proxy agent
}
}
See #107 for discussion.
translate(text: string, options?: Options): Promise<Response>
text
(string) - The text to be translatedoptions
(object)
from
(string) - The language of text
. Must be auto
or one of the supported languages. Default: auto
to
(string) - The language in which the text should be translated. Must be one of the supported languages. Default: auto
host
(string) - Google translate host to be used in API calls. Default: translate.google.com
fetchOptions
(object) - Additional fetch options passed into request.text
(string) – The translated text.raw
(object) - Raw responspe from the API. Contains sentences, detected original language and transliteration. Example response.MIT © Matheus Fernandes, forked and maintained by Vitaliy Potapov.
FAQs
A free and unlimited API for Google Translate
The npm package @vitalets/google-translate-api receives a total of 26,832 weekly downloads. As such, @vitalets/google-translate-api popularity was classified as popular.
We found that @vitalets/google-translate-api demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
At Node Congress, Socket CEO Feross Aboukhadijeh uncovers the darker aspects of open source, where applications that rely heavily on third-party dependencies can be exploited in supply chain attacks.
Research
Security News
The Socket Research team found this npm package includes code for collecting sensitive developer information, including your operating system username, Git username, and Git email.
Security News
OpenJS is warning of social engineering takeovers targeting open source projects after receiving a credible attempt on the foundation.