profanityfilter


A static node.js utility for masking words or phrases in strings that aren't allowed.

Installation

npm install profanityfilter

configuration

There are three methods of replacement, outlined below ('word' requires you specify a replacement for each word):

``javascript
stars - That * UX change was such a pain in the
grawlix - That &!%$ UX change was such a pain in the #@%
word - That darn UX change was such a pain in the badonkadonk
`

Note: 'stars' is the default method of replacement

methods

$3

Takes supplied string and runs the filter based on the current dictionary of unallowed words and replacement method. Returns the filtered string.

`javascript
var filter = require('profanity-filter');
console.log(filter.clean('String I\'d like to filter for inappropriate words.'));
`

$3

Populates the internal filter dictionary using a seed data JSON file (must live in lib/seeds).

`javascript
var filter = require('profanity-filter');
filter.seed('profanity');
`

###filter.debug()

Returns the dictionary, replacementMethod, and grawlixChars internal properties for debugging purposes.

`javascript
var filter = require('profanity-filter');
filter.debug()
`

$3

Globally sets the method of replacement. Accepts 'stars', 'word', and 'grawlix'.

`javascript
var filter = require('profanity-filter');
filter.setReplacementMethod('grawlix');
`

$3

Globally sets the grawlix characters to be used as replacements, if grawlix is the current replacementMethod.

`javascript
var filter = require('profanity-filter');
filter.setGrawlixChars(['1', '2', '3', '4', '5', '6']);
`

$3

Adds a word to the internal replacement dictionary. The optional second parameter is used if the replacementMethod is set to 'word'. If the word method is set and no replacement is passed, the filter will default to 'BLEEP'.

`javascript
var filter = require('profanity-filter');
filter.addWord('ass', 'badonkadonk');
`

$3

Removes a word from the internal replacement dicitonary.

`javascript
var filter = require('profanity-filter');
filter.removeWord('ass');
``