bing-translate

A simple and free package for Bing Translator for Node.js.

Install

npm i bingtranslator-for-free

Usage

From auto-detected language to English:-

1const { translate } = require('bingtranslator-for-free');
2
3translate('Salut', null, 'en').then(res => {
4  console.log(res.translation);
5}).catch(err => {
6  console.error(err);
7});

Translation result

1{
2  // original text
3  "text": "Salut",
4  // user-specified language code
5  "userLang": "auto-detect",
6  // translated text
7  "translation": "Hello",
8  // `correctedText` is returned only when `correct` is set as `true`
9  // supported since v1.1.0
10  "correctedText": "",
11  // detected language
12  "language": {
13    // language code of translated text
14    "to": "en",
15    // detected language code of original text
16    "from": "fr",
17    // score of language detection
18    // supported since v1.1.0
19    "score": 1
20  }
21}

API

translate(text, [from], [to], [correct], [raw], [userAgent], [proxyAgents])

text

Type: string

The text to be translated, can't be blank. The maximum text length is 1000.

from

Type: string Default: auto-detect

The language code of source text.

MUST be auto-detect or one of the codes/names (not case sensitive) contained in lang.json

to

Type: string Default: en

The language in which the text should be translated.

MUST be one of the codes/names (not case sensitive) contained in lang.json.

correct

Type: boolean Default: false Since: v1.1.0

Whether to correct the input text.

Note that:

1. There is currently a limit of 50 characters for correction service.
2. Only the languages in the list are supported to be corrected.

raw

Type: boolean Default: false

Whether the translation result contains raw response from Bing API.

userAgent

Type: string

The header value of user-agent used in API requests.

Default:

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36

proxyAgents

Type: Got['Agents'] Default: undefined Since: v2.4.0

Set agents of got for proxy.

Thanks

Great thanks to Bing Translator and plainheart.