yandex-translator

Introduction

yandex-translator is a a promise based implementation of Yandex Translate API for node.js

API key

To start using Yandex Translate API we need to get an API key first, which we will get it from the API key request form after having created an account the registration page.

Installation

npm install yandex-translator --save

Getting started

Import the yandex-translator package with with the API key obtained from the API key request form.

const yandexTranslator = require('yandex-translator')(apiKey);

Functions

yandexTranslator.getAvailableLanguages([parameters])

Get the languages that yandex-translator support their translation:

yandexTranslator.getAvailableLanguages().then(
    (result) => {
        console.log(result);
    },
    (error) => {
        console.log(error);
    }
);

The parameters parameter is an object which can contain any of the following attributes:

Attribute	Type	Description	Default value
[ui]	string	The returned language names are output in the language corresponding to the code in this parameter. The supported language codes are shown in the list of supported languages.
[resultFormat]	string	The result format which can be either JSON or XML.	JSON
[apiKey]	string	Another API key to run only this request with	The same value as the initialized API key.

yandexTranslator.detectLanguage(parameters)

Detect a text language:

yandexTranslator.detectLanguage({text: 'Bonjour'}).then(
    (result) => {
        console.log(result);
    },
    (error) => {
        console.log(error);
    }
);

The parameters parameter is an object which can contain any of the following attributes:

Attribute	Type	Description	Default value
text*	string	The text that we want to detect it's language.
[hints]	array	An array of the most likely languages (they will be given preference when detecting the text language).	[]
[resultFormat]	string	The result format which can be either JSON or XML.	JSON
[apiKey]	string	Another API key to run only this request with	The same value as the initialized API key.

yandexTranslator.detectLanguage(parameters)

Translate a text:

yandexTranslator.translate({text: 'Bonjour', to: 'en'}).then(
    (result) => {
        console.log(result);
    },
    (error) => {
        console.log(error);
    }
);

The parameters parameter is an object which can contain any of the following attributes:

Attribute	Type	Description	Default value
text*	string	The text that we want to detect it's language.
to*	string	The language which the text will be translated to.
[from]	string	The source language of the text. If it's then the service will try to detect the source language automatically.
[options]	integer	Whether the response should include the automatically detected language of the text being translated: 1 to include the automatically detected language of the text, 0 to not	1
[format]	string	The text format which can be plain (Text without markup) or html (Text in HTML format).	plain
[hints]	array	An array of the most likely languages (they will be given preference when detecting the text language).	[]
[resultFormat]	string	The result format which can be either JSON or XML.	JSON
[apiKey]	string	Another API key to run only this request with	The same value as the initialized API key.

Task Lists

• Add CLI support
• Add browser integration
• Create tests

License

MIT.