badwords-filter

Installation

npm i -s badwords-filter

An easy-to-use word filter with advanced detection techniques. A lightweight package with zero dependencies.

Features

• no case-sensitivity
• detects L33t text
• detects accented characters
• detects extra/missing repeated characters
• works with regex strings or normal strings

Usage

const Filter = require("badwords-filter");
const config = {
	list: ["test", "hello"],
	cleanWith: "$",
	useRegex: false,
};
const filter = new Filter(config);

Configuration options for filter

Property	Type	Default	Description
list	Array	en.json filterset	Array of filters in string format
cleanWith	String	"*"	Character or array of strings to replace bad words with in clean function
useRegex	boolean	false	Option to convert strings in list to regex expressions

Functions

Function	Parameters	Returns	Description
normalize	String message to normalize	String normalized message	converts to lowercase, normalizes accented characters, converts l33t text to normal text, removes excess non-alphabetical characters (automatically used in all package functions)
isUnclean	String message to check for cleanliness	Boolean true if contains any filtered word	parses message for any filtered words
clean	String message to clean	String cleaned message	replaces all filtered words with cleanWith character or a random string
getUncleanWordIndexes	String message to parse	Array <number> indexes of words that contain filtered words	gets indexes of all filtered words
isWordUnclean	String word to check	Boolean true if word is detected as a filtered word	checks if a word is filtered
debug	String message to test	undefined	prints to console the outputs of all functions on the given string

Example Detection

const Filter = require("badwords-filter");
const config = { list: ["hello"] };
const filter = new Filter(config);

//All the following would return true
filter.isUnclean("hello");
filter.isUnclean("HeLlO");
filter.isUnclean("h3ll0");
filter.isUnclean("heeeellloooo");
filter.isUnclean("heeeeellllooooooo there!!!");
filter.isUnclean("héllo");
filter.isUnclean("h.#ell-o");

Examples

Using a custom filter list

Normal strings filter

const Filter = require("badwords-filter");
const filter = new Filter({ list: ["badword"] });
filter.isUnclean("This sentence contains 'badword'"); // true
filter.isUnclean("This sentence does not contain any nasty words"); // false
filter.clean("This sentence contains 'badword'"); // "This sentence contains *********"
filter.getUncleanWordIndexes("This sentence contains 'badword'"); //[3]
filter.getUncleanWordIndexes("baaadword, goodword, okayword, badword"); // [0,3]
filter.isUnclean("baaaaaadw0rd"); //true

Regex strings filter

const Filter = require("badwords-filter");
const filter = new Filter({
	list: ["b.+d"], // any word that stars with b and ends with d
	useRegex: true,
});
filter.isUnclean("marching band"); // true
filter.clean("marching band"); // "marching ****"

Future Features

• support with phrases
• detects words with whitespace seperation
• more efficiency optimization
• sensitivity option for detection