words-count
TypeScript icon, indicating that this package has built-in type declarations

2.0.2 • Public • Published

Words Count

Words count for multi-languages paragraph mixed with numbers and punctuation.
One rule apply to all.

See Test Case

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/文字-chinese-cjk/cjk-characters-1/ http://jrgraphix.net/r/Unicode/0D00-0D7F

Readme

Keywords

none

Package Sidebar

Install

npm i words-count

Weekly Downloads

5,998

Version

2.0.2

License

MIT

Unpacked Size

2.78 MB

Total Files

24

Last publish

Collaborators

  • byn9826