Clean Your App’s Language: How to Use bad-word-checker for Profanity Filtering in JavaScript

Whether you're building a messaging app, a blog comment section, or a child-friendly platform, content moderation is a must.

In this tutorial, I’ll show you how to detect and censor bad words in both English and Hindi using a lightweight npm package: bad-word-checker.

---

🔍 What is itbad-word-checker?

bad-word-checkeris a zero-dependency JavaScript library that helps you:

• Detect offensive words in a string.

• Clean or censor those words with masking (like * or #).

• Add or remove custom words to fit your use case.

• Support multilingual filtering (currently English + Hindi).

---

📦 Installation

Just run:

npm install bad-word-checker

---

🚀 Basic Usage

import BadWords from "bad-word-checker";

const filter = new BadWords();

const text = "This is a damn message!";
console.log(filter.detect(text)); // true

const clean = filter.cleanWords(text);
console.log(clean); // "This is a **** message!"

---

🧠 Advanced Use Cases

➕ Add Custom Words

filter.addWords(["customword", "annoying"]);

➖ Remove Words

filter.removeWords(["damn"]);

🔍 Get All Bad Words from Text

filter.getBadWordsFromText("You are annoying and stupid.");
// Output: ["annoying", "stupid"]

🔢 Count Bad Words

filter.countBadWords("bad word bad word");
// Output: 2

🧼 Custom Masking

filter.cleanWords("bad word here", "#");
// Output: "### #### here"

---

🌐 Hindi Support

The package also supports some common Hindi profanities (devnagri and phonetic spellings). You can test this by typing a Hindi phrase with a bad word — it will still detect and clean it!

---

🧪 Use Cases

• Chat apps

• Blog comments

• Social platforms

• Gaming lobbies

• E-learning tools for kids

---

🤔 Why Use This?

• ✅ Zero dependencies & lightweight

• ✅ Multilingual

• ✅ Fully customizable

• ✅ Easy to integrate into any Node.js or browser-based project

---