https://github.com/khalyomede/translate
Translate a string using the free translate.googleapis.com endpoint (no API key required).
https://github.com/khalyomede/translate
free google javascript nodejs npm translate typescript unlimited
Last synced: 6 months ago
JSON representation
Translate a string using the free translate.googleapis.com endpoint (no API key required).
- Host: GitHub
- URL: https://github.com/khalyomede/translate
- Owner: khalyomede
- License: mit
- Created: 2020-05-29T23:44:13.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-06T07:24:04.000Z (almost 3 years ago)
- Last Synced: 2025-04-02T01:35:16.226Z (6 months ago)
- Topics: free, google, javascript, nodejs, npm, translate, typescript, unlimited
- Language: TypeScript
- Homepage: https://npmjs.com/package/@khalyomede/translate
- Size: 1.44 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# @khalyomede/translate
Translate a string using the free translate.googleapis.com endpoint (no API key required).
[](https://www.npmjs.com/package/@khalyomede/translate) [](https://github.com/khalyomede/translate/blob/master/LICENSE)   
## Summary
- [About](#about)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
## About
I want to build a small web app to translate a term into another (exactly like the Google Translate widget we can use when searching "XYZ in english").
The only packages on NPM I found are not working or use an API requiring an API key, which I do not want to use (because it asks for my credit card).
This package is using a public URL, which is not the same endpoint used in classic Google API. This URL has the huge advantage of not requiring any API key. The disadvantage is that it is not official (but used by several public translation services), so the result of the URL call might change (and I'll make sure when it happens to update it). It seems that the result has not changes in ages, but nothing is sure, so for huge scale project, you would not rely on this library, but rather using the official Google API.
## Requirements
- Node installed
- NPM or Yarn installed
## Installation
In your main project folder, add this package to your dependencies.
### Using NPM
```bash
npm install @khalyomede/translate
```
### Using Yarn
```bash
yarn add @khalyomede/translate
```
## Usage
- [1. Using NodeJS](#1-using-nodejs)
- [2. Using TypeScript](#2-using-typescript)
- [3. Using the browser](#3-using-the-browser)
### 1. Using NodeJS
In this example, we will simply translate the term "Hello" in French.
```javascript
const translate = require("@khalyomede/translate");
const main = async () => {
const translation = await translate("Hello", { from: "en", to: "fr" });
console.log("Hello in french is ", translation);
};
main();
```
### 2. Using TypeScript
This is the same example as above, but with typing support.
```typescript
import translate from "@khalyomede/translate";
const translation: string = await translate("Hello", [ from: "en", to: "fr" ]);
console.log("Hello in french is ", translation);
```
### 3. Using the browser
To work in the browser, you need to add a script tag to download Axios. Here is an example:
```html
Document
translate("Hello", { from: "en", to: "fr" }).then(function (translation) {
console.log("Hello in french is ", translation);
});
```