Language detection for Javascript. Based on the CLD2 (Compact Language Detector) library from Google. Highly optimized for space and speed. Runs about 10x faster than other libraries. Detects over 160 languages. Full test coverage. Runs on Linux, OS X, an
npm install cld
Language detection for Javascript. Based on the CLD2 (Compact Language Detector) library from Google.
Highly optimized for space and speed. Runs about 10x faster than other libraries. Detects over 160 languages. Full test coverage. Runs on Linux, OS X, and Windows.
``bash`
$ npm install cld
Linux users, make sure you have g++ >= 4.8. If this is not an option, you should be able to install node-cld 2.4.4 even with an older g++ build.
js
const cld = require('cld');// As a promise
cld.detect('This is a language recognition example').then((result) => {
console.log(result);
});
// In an async function
async function testCld() {
const result = await cld.detect('This is a language recognition example');
console.log(result);
}
`$3
js
const cld = require('cld');
const text = 'Това е пример за разпознаване на Български език';
const options = {
isHTML : false,
languageHint : 'BULGARIAN',
encodingHint : 'ISO_8859_5',
tldHint : 'bg',
httpHint : 'bg'
};// As a promise
cld.detect(text, options).then((result) => {
console.log(result);
});
// In an async function
async function testCld() {
const result = await cld.detect(text, options);
console.log(result);
}
`$3
Detect can be called leveraging the node callback pattern. If options are provided, the third parameter should be the callback.
javascript
const cld = require('cld');cld.detect('This is a language recognition example', (err, result) => {
console.log(result);
});
`Options
#### isHTML
Set to true if the string contains HTML tags
#### languageHint
Pass a LANGUAGES key or value as a hint
#### encodingHint
Pass an ENCODINGS value as a hint
#### tldHint
Pass top level domain as a hint
#### httpHint
Pass an HTTP "Content-Encoding" value as a hint
#### bestEffort
Set to true to give best-effort answer, instead of UNKNOWN_LANGUAGE. May be useful for
short text if the caller prefers an approximate answer over none.
Warning
Once the module has been installed, the underlying C sources will remain in the deps/cld` folder and continue to occupy considerable space. This is because they will be required if you ever need to run npm rebuild`. If you are under severe constraints you can delete this folder and reclam >100M