words-count
v2.0.2
Published
Words count for multi-languages paragraph mixed with numbers and punctuations
Downloads
25,348
Readme
Words Count
Words count for multi-languages paragraph mixed with numbers and punctuation.
One rule apply to all.
Install
npm i words-count
Example
import wordsCount from 'words-count';
// const wordsCount = require('words-count').default;
console.log(wordsCount('Hello World'));
Why use this
words_to_be_count = 'Hello “世界”';
words-count.js -> 3
words_to_be_count.length -> 10
words_to_be_count.split(' ').length -> 2
Countable.js -> 2
PHP str_word_count(words_to_be_count) -> 1
PHP mb_strlen(words_to_be_count) -> 10
Office Word -> 5
Special Rule
Numbers count as 1 word
Configs
const words = "Some words ...";
// Treat punctuation as word breaker
const total = wordsCount(words, {
punctuationAsBreaker: true
});
// Treat more characters as punctuation
const total = wordsCount(words, {
punctuation: ['-', 'a', 'b']
});
// Disable default built-in punctuation list
const total = wordsCount(words, {
disableDefaultPunctuation: true
});
Words Split
const words = "Some words ...";
const { wordsSplit, wordsDetect } = require('words-count');
const splittedWords = wordsSplit(words);
const { words, count } = wordsDetect(words);
Test Case
Test cases are based on best assumption.
Original Content:
Google's free service instantly translates words, phrases, and web pages between English and over 100 other languages.
Basic Test Content:
Translate original content into target language by Google Translate.
Test Case Coverage:
English, Chinese, Chinese-Traditional, Japanese, Korean, French, German,
Italian, Spanish, Portuguese, Russian, Ukrainian, Arabic, Hebrew, Afrikaans,
Albanian, Amharic, Armenian, Azerbaijani, Basque, Belarusian, Bengali,
Bulgarian, Bosnian, Catalan, Cebuano, Croatian, Chichewa, Corsican, Czech,
Danish, Dutch, Esperanto, Estonian, Filipino, Finnish, Frisian, Greek, Galician,
Georgian, Gujarati, Haitian Creole, Hausa, Hindi, Hmong, Hungarian, Icelandic,
Igbo, Indonesian, Irish, Javanese, Kannada, Kazakh, Kurdish, Kyrgyz, Latin,
Latvian, Lithuanian, Luxembourgish, Macedonian, Malagasy, Malay, Malayalam,
Nepali, Norwegian, Polish, Romanian, Serbian, Slovenian, Swedish, Turkish, Welsh
Zulu, Maori, Marathi, Mongolian, Pashto, Persian, Punjabi, Scots Gaelic, Sesotho,
Shona, Sindhi, Sinhala, Slovak, Somali, Sundanese, Swahili, Tajik, Turkish,
Urdu, uzbek, Vietnamese, Xhosa, Yiddish, Yoruba
Failed/Unknown:
Hawalian, Khmer, Lao, Maltese, Myanmar, Tamil, Thai
Reference
http://php.net/manual/en/function.str-word-count.php#109733
https://www.key-shortcut.com/en/writing-systems/%E6%96%87%E5%AD%97-chinese-cjk/cjk-characters-1/
http://jrgraphix.net/r/Unicode/0D00-0D7F