Count Words

A lightweight JavaScript/TypeScript library to count words in a string. It handles multiple consecutive spaces correctly and is Unicode-aware.

Features

✨ Simple and intuitive API
🚀 Fast and efficient word counting
🔧 Handles multiple consecutive spaces
🌍 Unicode-aware
📦 Works with Deno, Node.js, and browsers
🎯 Zero dependencies

Quick Start

Deno 🦕

import { countWords } from "https://deno.land/x/count_words/mod.ts";

console.log(countWords("Hello World")); // 2
console.log(countWords("The quick brown fox")); // 4

Node.js 🐢🚀

import { countWords } from "count-n-words";

console.log(countWords("Hello World")); // 2
console.log(countWords("The quick brown fox")); // 4

Browser 🌐

You can use any CDN 🔥

<script type="module">
  import { countWords } from "https://cdn.skypack.dev/count-n-words";

  console.log(countWords("Hello World")); // 2
</script>

Other CDN options:

API Reference

`countWords(text: string, separator?: string): number`

Counts the number of words in a string.

Parameters

text (string): The text to count words in
separator (string, optional): The separator between words. Defaults to " " (space)

Returns

(number): The number of words found in the text

Examples

// Basic usage
countWords("Hello World"); // 2
countWords("Hey, my name is Eliaz."); // 5

// Handles multiple spaces
countWords("Hello        World"); // 2
countWords("  Hey  "); // 1

// Empty strings
countWords(""); // 0
countWords("   "); // 0

// Custom separator
countWords("apple,banana,orange", ","); // 3

Documentation

Full API documentation is hosted on Deno Doc 📄

Support

Open an Issue, I will check it a soon as possible 👀

If you want to hurry me up a bit send me a tweet 😆

Consider supporting me on Patreon if you like my work 🙏

Don’t forget to start the repo ⭐

Authors

Eliaz Bobadilla - Creator and Maintainer 💪

See also the full list of contributors who participated in this project ✨

Versioning

We use Semantic Versioning. For the versions available, see the tags 🏷️

Licence

Licensed under the MIT License 📄