@akgargo/ms-translator-api-client
v0.0.4
Published
Node JS Client Library for using Microsoft Azure Translator API
Downloads
12
Maintainers
Readme
Microsoft Translator API Client
non-official package that enables a Microsoft Azure Translator API Client for NodeJS
This package was created as response of a lack of official packages for consuming MS Translator API in NodeJS applications.It provides an easy way to consume their enpointsand its fully extensible by adding layers of abstraction for business logic.
This package is currently a beta version and only supports "languages", "detect", "translate" and "transliterate" endpoints of the Azure Text Translation REST API
Installing / Getting Started
This package is only available for NodeJS and should be installed using NPM by running the commands below:
Open a command line and make sure you are in your project's root directory before installing it
cd development/my-awesome-project/
Now, let's install this package
npm i @akgargo/ms-translator-api-client
Quick Start
The usage of this API client is very intuitive if you have already read the official Microsoft documentation. I higly recommend you to uderstand how the API works first, as this is only an abstracion layer that help you to reduce boilerplate code directly in your application for using MS Azure translation capabilities.
Creating a client
import { MicrosoftTextTranslator } from '@akgargo/ms-translator-api-client';
const translator = new MicrosoftTextTranslator({ subscriptionKey: <YOUR_AZURE_TRANSLATOR_KEY> })
Translating some text
translator.translate({
text: ["Hello world", "This are two different texts to be translated in a single call"],
to: "es"
})
.then(translation => {
console.log(JSON.stringify({ translation }, null, 2))
});
The code above should print in the console
{
"translation": [
{
"detectedLanguage": {
"language": "en",
"score": 1
},
"translations": [
{
"text": "Hola mundo",
"to": "es"
}
]
},
{
"detectedLanguage": {
"language": "en",
"score": 1
},
"translations": [
{
"text": "Se trata de dos textos diferentes a traducir en una sola convocatoria",
"to": "es"
}
]
}
]
}
Usage
Languages endpoint
Usage
translator.languages({}).then(languages => {
console.log(JSON.stringify({ languages }, null, 2))
});
Result
{
"detection": [
{
"translation": {
"af": {
"name": "Afrikaans",
"nativeName": "Afrikaans",
"dir": "ltr"
},
....
},
"transliteration": {
"ar": {
"name": "Arabic",
"nativeName": "العربية",
"scripts": [
{
"code": "Arab",
"name": "Arabic",
"nativeName": "العربية",
"dir": "rtl",
"toScripts": [
{
"code": "Latn",
"name": "Latin",
"nativeName": "اللاتينية",
"dir": "ltr"
}
]
},
{
"code": "Latn",
"name": "Latin",
"nativeName": "اللاتينية",
"dir": "ltr",
"toScripts": [
{
"code": "Arab",
"name": "Arabic",
"nativeName": "العربية",
"dir": "rtl"
}
]
}
]
},
...
},
"dictionary": {
"af": {
"name": "Afrikaans",
"nativeName": "Afrikaans",
"dir": "ltr",
"translations": [
{
"name": "English",
"nativeName": "English",
"dir": "ltr",
"code": "en"
}
]
},
...
}
}
]
}
Detect endpoint
Usage
translator.detect({
text: ['Bonjour']
}).then(detection => {
console.log(JSON.stringify({ detection }, null, 2))
});
Result
{
"detection": [
{
"language": "fr",
"score": 1,
"isTranslationSupported": true,
"isTransliterationSupported": false
}
]
}
Translate endpoint
Usage
translator.translate({
text: ['Bonjour'],
to: "en"
}).then(translation => {
console.log(JSON.stringify({ translation }, null, 2))
});
Result
{
"translation": [
{
"detectedLanguage": {
"language": "fr",
"score": 1
},
"translations": [
{
"text": "Hello",
"to": "en"
}
]
}
]
}
Transliterate endpoint
Usage
translator.transliterate({
text: ["こんにちは"],
language: "ja",
fromScript: "Jpan",
toScript: "Latn",
}).then(transliteration => {
console.log(JSON.stringify({ transliteration }, null, 2))
});
Result
{
"transliteration": [
{
"text": "Kon'nichiwa",
"script": "Latn"
}
]
}