Nepali-profanity-detector NPM

nepali-profanity-detector

Detect Nepali profane words with configurable options.

Install

npm i nepali-profanity-detector

Usage

import { hasProfane } from "nepali-profanity-detector";

console.log(hasProfane("Oi muji")); // true
console.log(hasProfane("Oi mUjI")); // true
console.log(hasProfane("Oi yaar")); // false

// detects accent by default
console.log(hasProfane("Oi ḿüjį")); // true

// change behavior to throw error
hasProfane("Oi muji", { behavior: "THROW_ERR" }); // throws new Error("Nepali profanity detected")

// change behavior to throw custom error
hasProfane("Oi muji", {
  behavior: "THROW_ERR",
  error: new AppError("My Custom Error", 400),
}); // throws new new AppError("My Custom Error", 400)

// add your custom profane by blacklisting them
console.log(hasProfane("test", { blacklist: ["test"] })); // true

// whitelist your custom words
console.log(hasProfane("muji", { whitelist: ["muji"] })); // false

You also have the option to import Behavior as follows:

import { hasProfane, Behavior } from "nepali-profanity-detector";

// throws error
hasProfane("muji", { behavior: Behavior.THROW_ERR });

// returns boolean, also default behavior so you can omit behavior option
hasProfane("muji", { behavior: Behavior.RETURN_BOOLEAN });

`options`

Key	Description	Default
`includeAccents`	Allows accents like `ä` to be interpreted as `a`.	`true`
`trimSymbols`	Removes any non-alphanumeric characters. For eg. `m.u.j.i` will be interpreted as `muji`.	`true`
`behavior`	Change whether the function should return boolean or throw error if profanity is detected.	`Behavior.RETURN_BOOLEAN`
`error`	Pass custom error to be thrown IF behavior is set to `"THROW_ERR"` or `Behavior.THROW_ERR`	`new Error("Nepali profanity detected")`
`blacklist`	Pass your custom profane words in an array of strings.	[]
`whitelist`	Pass your custom words to be ignored when detecting profane.	[]