seiyria

censor-sensor

(function webpackUniversalModuleDefinition(root, factory) {

	if(typeof exports === 'object' && typeof module === 'object')

	else if(typeof define === 'function' && define.amd)

})(typeof self !== 'undefined' ? self : this, function() {

return /******/ (function(modules) { // webpackBootstrap

/******/ 	function __webpack_require__(moduleId) {

/******/ 		// Check if module is in cache

/******/ 		if(installedModules[moduleId]) {

/******/ 			return installedModules[moduleId].exports;

/******/ 		// Create a new module (and put it into the cache)

/******/ 		var module = installedModules[moduleId] = {

/******/ 		// Execute the module function

/******/ 		modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);

/******/ 		// Return the exports of the module

/******/ 	// expose the modules object (__webpack_modules__)

/******/ 	__webpack_require__.m = modules;

/******/ 	__webpack_require__.c = installedModules;

/******/ 	// define getter function for harmony exports

/******/ 	__webpack_require__.d = function(exports, name, getter) {

/******/ 		if(!__webpack_require__.o(exports, name)) {

/******/ 			Object.defineProperty(exports, name, {

/******/ 	// getDefaultExport function for compatibility with non-harmony modules

/******/ 	__webpack_require__.n = function(module) {

/******/ 		var getter = module && module.__esModule ?

/******/ 			function getDefault() { return module['default']; } :

/******/ 			function getModuleExports() { return module; };

/******/ 		__webpack_require__.d(getter, 'a', getter);

/******/ 	// Object.prototype.hasOwnProperty.call

/******/ 	__webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };

/******/ 	// Load entry module and return exports

/******/ 	return __webpack_require__(__webpack_require__.s = 0);

/************************************************************************/

/***/ (function(module, exports, __webpack_require__) {

    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];

Object.defineProperty(exports, "__esModule", { value: true });

const locales_1 = __webpack_require__(2);

    CensorTier[CensorTier["Slurs"] = 1] = "Slurs";

    CensorTier[CensorTier["CommonProfanity"] = 2] = "CommonProfanity";

        if (!this.enabledTiers[wordTier])

        const dict = this.currentDictionary;

        return this.prepareForParsing(phrase).split(' ').some(word => this._isProfane(word, dict));

        Object.keys(dict).forEach(dictWord => {

            if (this.blackList[dictWord])

            if (phrase.indexOf(dictWord) !== -1 && this.enabledTiers[tier])

        return this._isProfaneIsh(this.prepareForParsing(phrase), dict);

                foundProfanity.push(dictWord);

        return this._profaneIshWords(phrase, dict);

        const cleanFunc = this.cleanFunction;

        const joinPhrase = phrase.split(' ').map(word => {

            if (!this._isProfane(word.toLowerCase(), dict))

        const comparePhrase = this.prepareForParsing(phrase);

        const allProfanity = this.profaneIshWords(comparePhrase);

            const regex = new RegExp(word, 'gi');

            phrase = phrase.replace(regex, cleanFunc(word));

module.exports = {"bollocks":4,"dingleberry":4,"dingleberries":4,"douche":4,"suck":4,"sucks":4,"anal":3,"anus":3,"bdsm":3,"bestiality":3,"blowjob":3,"bondage":3,"boner":3,"boobs":3,"boob":3,"bukkake":3,"bunghole":3,"butt":3,"circlejerk":3,"clit":3,"clitoris":3,"cocks":3,"cock":3,"creampie":3,"cum":3,"cumming":3,"deepthroat":3,"dick":3,"dildo":3,"dominatrix":3,"dommes":3,"domme":3,"ecchi":3,"ejaculation":3,"erotic":3,"fellatio":3,"femdom":3,"fetish":3,"fingerbang":3,"futanari":3,"genitals":3,"grope":3,"g-spot":3,"handjob":3,"hentai":3,"homoerotic":3,"humping":3,"incest":3,"intercourse":3,"jailbait":3,"jizz":3,"kinkster":3,"kinky":3,"masturbate":3,"masturbation":3,"milf":3,"nipples":3,"nipple":3,"nude":3,"nudity":3,"nympho":3,"nymphomaniac":3,"orgasm":3,"orgy":3,"pedobear":3,"pedophile":3,"paedophile":3,"panty":3,"panties":3,"pegging":3,"penis":3,"playboy":3,"poon":3,"porn":3,"pubes":3,"pussy":3,"queef":3,"queaf":3,"rape":3,"raping":3,"rapist":3,"rectum":3,"scat":3,"schlong":3,"semen":3,"sex":3,"sexy":3,"skeet":3,"sodomize":3,"sodomy":3,"spooge":3,"splooge":3,"spunk":3,"swinger":3,"threesome":3,"titties":3,"titty":3,"tits":3,"tit":3,"tosser":3,"tubgirl":3,"twat":3,"upskirt":3,"vagina":3,"vibrator":3,"voyeur":3,"vulva":3,"wank":3,"yaoi":3,"yuri":3,"arsehole":2,"arse":2,"asshole":2,"assface":2,"asshat":2,"ass":2,"bastards":2,"bastard":2,"bitching":2,"bitchin":2,"bitches":2,"bitch":2,"bullshit":2,"damnit":2,"damn":2,"fucktards":2,"fucktard":2,"fucking":2,"fuckers":2,"fucker":2,"fuck":2,"god damn":2,"goddamn":2,"hell":2,"motherfucker":2,"pissing":2,"pissed":2,"piss":2,"shitter":2,"shitty":2,"shit":2,"beaners":1,"beaner":1,"bimbo":1,"coon":1,"coons":1,"cunt":1,"cunts":1,"darkie":1,"darkies":1,"fag":1,"fags":1,"faggot":1,"faggots":1,"hooker":1,"kike":1,"kikes":1,"nazi":1,"nazis":1,"neonazi":1,"neonazis":1,"negro":1,"negros":1,"nigga":1,"niggas":1,"nigger":1,"niggers":1,"paki":1,"pakis":1,"raghead":1,"ragheads":1,"shemale":1,"shemales":1,"slut":1,"sluts":1,"spic":1,"spics":1,"swastika":1,"towelhead":1,"towelheads":1,"tranny":1,"trannys":1,"trannies":1,"twink":1,"twinks":1,"wetback":1,"wetbacks":1}

  "description": "a better profanity filter",

    "build": "webpack --config webpack.config.js",

    "url": "git+https://github.com/seiyria/censor-sensor.git"

  "author": "Kyle Kemp <kyle@seiyria.com>",

    "url": "https://github.com/seiyria/censor-sensor/issues"

  "homepage": "https://github.com/seiyria/censor-sensor#readme",

    "awesome-typescript-loader": "^3.4.1",

Every other profanity filter just seems to be an array of words, checked against every word in a phrase. This is ridiculous - it's an O(N^2) check when it only needs to be O(N). Of course, this library, by default, only requires an O(N) check (and that's against your phrase; not my words). You can opt in to a "like" check which will check every word and try to match it to a substring.

Every other profanity filter also seems to neglect "tiers" of words. You might want to filter out slurs, but not common profanity. You can do that here.

If you want, you can pass a function that lets you censor words how you want. By default, it will be replaced with the `*` character in quantity based on the word (so "fuck" translates to "****").

That said, this library only has a list for english (`en`), but could be extended to add more fairly easily.

You can remove or add words at run time. By default, they'll be assigned the lowest tier (5).

Words are shamelessly based on [profanity-cleanser](https://github.com/LDNOOBW/profanity-cleanser), because I'm not creative enough to think of some of these.

import { CensorSensor } from 'censor-sensor';

// check for profanity (using string.includes)

censor.isProfaneIsh('bollockshead') // true

censor.isProfaneIsh('hello')        // true

// get the words that are profane from a phrase

censor.profaneIshWords('hello')     // ['hell']

censor.cleanProfanity('bollocks')   // '****' (by default)

censor.cleanProfanityIsh('hello')   // '****o' (by default)

censor.setCleanFunction((str) => Array.from(str, x => '%').join('')); // replace all bad characters with '%'

censor.cleanProfanity('bollocks')   // '%%%%%%%%' (by default)

censor.isProfane('bollocks')    // false 

censor.isProfane('uwotm8')                // false

censor.addLocale('custom', { uwotm8: 1 }) // the highest form of insult

censor.isProfane('uwotm8')                // true

// remove an existing word from an existing tier

As stated before, every word has a tier associated with it. Here is what each tier number means:

Feel free to contribute words, locales, or features.

  private locale: CensorLocale|string = 'en';

  private blackList: { [word: string]: boolean } = {};

  private customDictionary: { [word: string]: CensorTier } = {};

  private enabledTiers: { [tier: string]: boolean } = {

  private defaultCleanFunction: (str: string) => string = (str: string) => '****';

  private customCleanFunction: (str: string) => string;

  private get currentDictionary(): { [word: string]: CensorTier } {

    return Object.assign({}, AllLocales[this.locale], this.customDictionary);

  private get cleanFunction(): (str: string) => string {

    return this.customCleanFunction || this.defaultCleanFunction;

  public addLocale(newLocale: string, dict: { [word: string]: CensorTier }): void {

  public setLocale(locale: CensorLocale|string): void {

  public disableTier(tier: CensorTier): void {

  public enableTier(tier: CensorTier): void {

  public addWord(word: string, tier: CensorTier = CensorTier.UserAdded): void {

  public removeWord(word: string): void {

  private prepareForParsing(phrase: string): string {

  private _isProfane(word: string, dict: { [word: string]: CensorTier }): boolean {

    if(this.blackList[word]) return false;

    if(!this.enabledTiers[wordTier]) return false;

  public isProfane(phrase: string): boolean {

    return this.prepareForParsing(phrase).split(' ').some(word => this._isProfane(word, dict));

  private _isProfaneIsh(phrase: string, dict: { [word: string]: CensorTier }): boolean {

    Object.keys(dict).forEach(dictWord => {

      if(this.blackList[dictWord]) return;

      if (phrase.indexOf(dictWord) !== -1 && this.enabledTiers[tier]) isAnyMatch = true;

  public isProfaneIsh(phrase: string): boolean {

    return this._isProfaneIsh(this.prepareForParsing(phrase), dict);

  private _profaneIshWords(phrase: string, dict: { [word: string]: CensorTier }): string[] {

      if(phrase.indexOf(dictWord) !== -1 && this.enabledTiers[tier]) foundProfanity.push(dictWord);

  public profaneIshWords(phrase: string) {

    return this._profaneIshWords(phrase, dict);

  public setCleanFunction(func: (str: string) => string): void {

  public cleanProfanity(phrase: string): string {

    const cleanFunc = this.cleanFunction;

    const joinPhrase = phrase.split(' ').map(word => {

      if(!this._isProfane(word.toLowerCase(), dict)) return word;

  public cleanProfanityIsh(phrase: string): string {

    const comparePhrase = this.prepareForParsing(phrase);

    const allProfanity = this.profaneIshWords(comparePhrase);

      const regex = new RegExp(word, 'gi');

      phrase = phrase.replace(regex, cleanFunc(word));

		@@ -154,2 +154,4 @@ (function webpackUniversalModuleDefinition(root, factory) {
		_isProfane(word, dict) {
		if (this.blackList[word])
		return false;
		const wordTier = dict[word];
		@@ -171,2 +173,4 @@ if (!wordTier)
		return;
		if (this.blackList[dictWord])
		return;
		const tier = dict[dictWord];
		@@ -185,2 +189,4 @@ if (phrase.indexOf(dictWord) !== -1 && this.enabledTiers[tier])
		Object.keys(dict).forEach(dictWord => {
		if (this.blackList[dictWord])
		return;
		const tier = dict[dictWord];
		@@ -187,0 +193,0 @@ if (phrase.indexOf(dictWord) !== -1 && this.enabledTiers[tier])

		{
		"name": "censor-sensor",
		"version": "1.0.5",
		"version": "1.0.6",
		"description": "a better profanity filter",
		@@ -5,0 +5,0 @@ "main": "./dist/index.js",

		@@ -73,2 +73,7 @@ # Censor Sensor
		censor.isProfane('uwotm8') // false

		// remove an existing word from an existing tier
		censor.isProfane('hell') // true
		censor.removeWord('hell')
		censor.isProfane('hell') // false
		```
		@@ -75,0 +80,0 @@

		@@ -76,2 +76,4 @@ import { AllLocales } from '../locales';
		private _isProfane(word: string, dict: { [word: string]: CensorTier }): boolean {
		if(this.blackList[word]) return false;

		const wordTier = dict[word];
		@@ -96,2 +98,3 @@
		if(isAnyMatch) return;
		if(this.blackList[dictWord]) return;

		@@ -116,2 +119,4 @@ const tier = dict[dictWord];
		Object.keys(dict).forEach(dictWord => {
		if(this.blackList[dictWord]) return;

		const tier = dict[dictWord];
		@@ -118,0 +123,0 @@

Improved metrics