Have ideas to improve npm?Join in the discussion! »

    bing-translate-api

    2.0.0 • Public • Published

    bing-translate-api

    NPM version Auto Test NPM Downloads License

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

    Install

    npm install bing-translate-api
    

    Usage

    From auto-detected language to English:

    const { translate } = require('bing-translate-api');
    
    translate('你好', null, 'en', true).then(res => {
      console.log(res.translation);
    }).catch(err => {
      console.error(err);
    });

    Translation result

    {
      "text": "你好",
      "userLang": "auto-detect",
      "translation": "Hello",
      // `correctedText` is returned only when `correct` is set as `true`
      // supported since v1.1.0
      "correctedText": "",
      "language": {
        "to": "en",
        "from": "zh-Hans",
        // supported since v1.1.0
        "score": 1
      }
    }

    API

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

    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.js

    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.js.

    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.

    tld

    Type: string Default: ''

    Can be 'www' | 'cn' | ''

    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/90.0.4430.212 Safari/537.36
    

    License

    MIT © 2021 plainheart.

    Thanks

    Great thanks to Bing Translator for providing so excellent translation service.

    Install

    npm i bing-translate-api

    DownloadsWeekly Downloads

    199

    Version

    2.0.0

    License

    MIT

    Unpacked Size

    15.8 kB

    Total Files

    7

    Last publish

    Collaborators

    • avatar