Linguister NPM

Linguister

A free and unlimited API for Google Translate built in typescript :dollar::no_entry_sign:

Features

Auto language detection
Full typing
Spelling correction
Language correction
Fast and reliable – it uses the same servers that translate.google.com uses

Install

npm install --save linguister

Usage

The module automatically exposes a default wrapper through the translate export, however if you want to spawn the requests differently, you can extend Linguister.TranslateAPI, calling _translate for the API request

From automatic language detection to English:

import {translate} from 'linguister'

translate('Ik spreek Engels', {to: 'en'}).then(res => {
    console.log(res.text)
    //=> I speak English
    console.log(res.from.language.iso)
    //=> nl
}).catch(err => {
    console.error(err)
})

From English to Dutch with a typo:

translate('I spea Dutch!', {from: 'en', to: 'nl'}).then(res => {
    console.log(res.text)
    //=> Ik spreek Nederlands!
    console.log(res.from.text.autoCorrected)
    //=> true
    console.log(res.from.text.value)
    //=> I [speak] Dutch!
    console.log(res.from.text.didYouMean)
    //=> false
}).catch(err => {
    console.error(err)
})

Sometimes, the API will not use the auto corrected text in the translation:

translate('I spea Dutch!', {from: 'en', to: 'nl'}).then(res => {
    console.log(res);
    console.log(res.text)
    //=> Ik spea Nederlands!
    console.log(res.from.text.autoCorrected)
    //=> false
    console.log(res.from.text.value)
    //=> I [speak] Dutch!
    console.log(res.from.text.didYouMean)
    //=> true
}).catch(err => {
    console.error(err)
})

API

Translation

The class the API responds with

Properties

text string – The translated text
from Object Details about the original text
- from.language.didYouMean Boolean True if the API suggested a correction in the source language
- from.language.didYouMean String The ISO 639-I language code of the language that the API has recognized in the text
- from.text.value String The untranslated auto corrected text or suggested text
- from.text.autoCorrected Boolean True if the API has auto corrected the text
- from.text.didYouMean Boolean True if the API has suggested corrections to the text
raw Array The raw response from th egoogle translate server

LangFrom

Returns the ISO 639-1 code of the desiredLang – if it is supported by Google Translate

Parameters

query string – the name or the code of the desired language

Returns string The ISO 639-1 code of the language

TranslateAPI

Used to spawn api requests. Will handle a ratelimit

Parameters

ratelimit (optional, default 1000)

translate

Translate a string using google's translate API

Parameters

text String The text to translate
opts Object Options for the request (optional, default {})
- opts.from String? The language to translate from
- opts.to String? The language to translate to