Socket
Socket
Sign inDemoInstall

@akgargo/ms-translator-api-client

Package Overview
Dependencies
9
Maintainers
1
Versions
4
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@akgargo/ms-translator-api-client

Node JS Client Library for using Microsoft Azure Translator API


Version published
Maintainers
1
Weekly downloads
1

Weekly downloads

Readme

Source

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"
    }
  ]
}

Keywords

FAQs

Last updated on 16 Aug 2022

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.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc