npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

translatte

v3.0.1

Published

A free and unlimited translate for NodeJS

Downloads

51,801

Readme

A free and unlimited translate for NodeJS.

Installation

npm i translatte

Usage

Translate string to German:

const translatte = require('translatte');

translatte('Do you speak Russian?', {to: 'de'}).then(res => {
    console.log(res.text);
}).catch(err => {
    console.error(err);
});
// Ihr sprecht auf Russisch?

Translate string to English using proxy:

const translatte = require('translatte');

translatte('Вы говорите по-русски?', {
    from: 'ru',
    to: 'en',
    agents: [
        'Mozilla/5.0 (Windows NT 10.0; ...',
        'Mozilla/4.0 (Windows NT 10.0; ...',
        'Mozilla/5.0 (Windows NT 10.0; ...'
    ],
    proxies: [
        'LOGIN:[email protected]:12345',
        'LOGIN:[email protected]:54321'
    ]
}).then(res => {
    console.log(res);
}).catch(err => {
    console.error(err);
});
// { text: 'Do you speak Russian?', 
//   from: { 
//     language: { 
//       didYouMean: false, 
//       iso: 'ru' 
//     }, 
//     text: { 
//       autoCorrected: false, 
//       value: '', 
//       didYouMean: false 
//     } 
//   },
//   raw: '' }

API

translatte(text, options)

text

Type: string

The text to be translated.

options

Type: object

from

Type: string Default: auto

The text language. Must be auto or one of the codes/names (not case sensitive) contained in languages.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 languages.js.

raw

Type: boolean Default: false

If true, the returned object will have a raw property with the raw response (string) from Google Translate.

agents

Type: array Default: []

An array of strings specifying the user-agent ['Mozilla/5.0 ...', 'Mozilla/4.0 ...']. One random result will be selected.

proxies

Type: array Default: []

An array of strings LOGIN:PASSWORD@IP:PORT specifying the proxies ['LOGIN:[email protected]:12345', 'LOGIN:[email protected]:54321']. One random result will be selected.

tld

Type: string Default: com

TLD for Google translate host to be used in API calls: https://translate.google.[tld]

client

Type: string Default: t

Query parameter client used in API calls. Can be t|gtx.

priority

Type: array Default: ['google_free']

Array of priority services.

services

Type: object Default: {"google_free": true}

Objects in order of priority, if one of the services does not perform the translation, it proceeds to the next.

Supported services:

  • {"google_free": true}
    • Google Translate, this service works by default. It is completely free and has no limits.
  • {"google_v3": {"project-id": "XXX", "token": "YYY"}}
    • Google Cloud, requires registration and credit card details. 500,000 characters per month are issued free of charge, then $20 for every million characters.
  • {"microsoft_v3": {"key": "XXX", "location": "global"}}
    • Microsoft Azure, requires registration and credit card details. Free of charge 2,000,000 characters per month, then $10 for every million characters.
  • {"yandex_v1": {"key": "XXX"}}
    • Yandex Translate, requires registration. Free of charge 10,000,000 characters per month.
  • {"yandex_v2": {"key": "XXX"}}
    • Yandex Cloud, requires registration and credit card details. $15 for every million characters.

Returns an object:

  • text (string) – The translated text.
  • from (object)
    • language (object)
      • didYouMean (boolean) - true if the API suggest a correction in the source language
      • iso (string) - The code of the language that the API has recognized in the text
    • text (object)
      • autoCorrected (boolean)true if the API has auto corrected the text
      • value (string) – The auto corrected text or the text with suggested corrections
      • didYouMean (boolean)true if the API has suggested corrections to the text
  • raw (string) - If options.raw is true, the raw response from Google Translate servers. Otherwise, ''.
  • proxy (string) – The proxy that were used in the request.
  • agent (string) – The agent that were used in the request.
  • service (object) – The service that were used in the request.

Note that res.from.text will only be returned if from.text.autoCorrected or from.text.didYouMean equals to true. In this case, it will have the corrections delimited with brackets ([ ]):

translate('I spea Dutch').then(res => {
    console.log(res.from.text.value);
    //=> I [speak] Dutch
}).catch(err => {
    console.error(err);
});

Otherwise, it will be an empty string ('').

Errors an object:

Errors in the name of each services.

{
  "google_free": "Could not get token from google",
  "google_v3": "Response code 403 (Forbidden)",
  "microsoft_v3": "Response code 403 (Forbidden)",
  "yandex_v1": "Response code 403 (Forbidden)",
  "yandex_v2": "Response code 403 (Forbidden)"
}

If the proxy server LOGIN:[email protected]:12345 is inactive.

{
  "google_free": "LOGIN:[email protected]:12345"
}

If the error is not related to services.

{
  "message": "The language «foo» is not supported"
}

2020 ExtensionsApp