google translate api

google-translate-api

Une API gratuite et illimitée pour Google Translate ?

Caractéristiques

• Détection automatique de la langue
• Correction orthographique
• Correction de la langue
• Rapide et fiable : il utilise les mêmes serveurs que ceux utilisés par translation.google.com

Installer

 npm install --save google-translate-api

Usage

De la détection automatique de la langue à l'anglais :

 const translate = require ( 'google-translate-api' ) ;

translate ( 'Ik spreek Engels' , { to : 'en' } ) . then ( res => {
    console . log ( res . text ) ;
    //=> I speak English
    console . log ( res . from . language . iso ) ;
    //=> nl
} ) . catch ( err => {
    console . error ( err ) ;
} ) ;

De l'anglais vers le néerlandais avec une faute de frappe :

 translate ( 'I spea Dutch!' , { from : 'en' , to : 'nl' } ) . then ( res => {
    console . log ( res . text ) ;
    //=> Ik spreek Nederlands!
    console . log ( res . from . text . autoCorrected ) ;
    //=> true
    console . log ( res . from . text . value ) ;
    //=> I [speak] Dutch!
    console . log ( res . from . text . didYouMean ) ;
    //=> false
} ) . catch ( err => {
    console . error ( err ) ;
} ) ;

Parfois, l'API n'utilise pas le texte corrigé automatiquement dans la traduction :

 translate ( 'I spea Dutch!' , { from : 'en' , to : 'nl' } ) . then ( res => {
    console . log ( res ) ;
    console . log ( res . text ) ;
    //=> Ik spea Nederlands!
    console . log ( res . from . text . autoCorrected ) ;
    //=> false
    console . log ( res . from . text . value ) ;
    //=> I [speak] Dutch!
    console . log ( res . from . text . didYouMean ) ;
    //=> true
} ) . catch ( err => {
    console . error ( err ) ;
} ) ; 

API

traduire (texte, options)

texte

Type : string

Le texte à traduire

choix

Type : object

depuis

Type : string par défaut : auto

La langue text . Doit être auto ou l'un des codes/noms (non sensibles à la casse) contenus dans Languages.js

à

Type : string Par défaut : en

La langue dans laquelle le texte doit être traduit. Doit être l'un des codes/noms (non sensibles à la casse) contenus dans Languages.js.

brut

Type : boolean par défaut : false

Si true , l'objet renvoyé aura une propriété raw avec la réponse brute ( string ) de Google Translate.

Renvoie un object :

• text (string) – Le texte traduit.
• from (objet)
  • language (objet)
    • didYouMean (booléen) - true si l'API suggère une correction dans la langue source
    • iso (string) - Le code de la langue que l'API a reconnue dans le text
  • text (objet)
    • autoCorrected (booléen) – true si l'API a automatiquement corrigé le text
    • value (chaîne) – Le text corrigé automatiquement ou le text avec les corrections suggérées
    • didYouMean (booelan) – true si l'API a suggéré des corrections au text
• raw (string) - Si options.raw est vrai, la réponse brute des serveurs Google Translate. Sinon, '' .

Notez que res.from.text ne sera renvoyé que si from.text.autoCorrected ou from.text.didYouMean est égal à true . Dans ce cas, les corrections seront délimitées par des parenthèses ( [ ] ) :

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

Sinon, ce sera une string vide ( '' ).

En rapport

• vertaler – CLI pour ce module

Licence

MIT © Matheus Fernandes