1.3.0 • Published 2 years ago
badwords-filter v1.3.0
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