https://github.com/vandie/isprofanity
A profanity checker which, unlike alternatives, uses the Wagner–Fischer algorithm in order to catch variations that you haven't thought of.
https://github.com/vandie/isprofanity
abuse abuse-detection filter implementation mit mit-license module nodejs profanity swear swearword
Last synced: about 1 month ago
JSON representation
A profanity checker which, unlike alternatives, uses the Wagner–Fischer algorithm in order to catch variations that you haven't thought of.
- Host: GitHub
- URL: https://github.com/vandie/isprofanity
- Owner: vandie
- License: mit
- Created: 2017-03-05T11:15:19.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-11-16T21:54:06.000Z (over 5 years ago)
- Last Synced: 2025-03-28T22:22:40.800Z (about 2 months ago)
- Topics: abuse, abuse-detection, filter, implementation, mit, mit-license, module, nodejs, profanity, swear, swearword
- Language: JavaScript
- Size: 2.8 MB
- Stars: 11
- Watchers: 2
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# isProfanity (not maintained)
A profanity checker which, unlike alternatives, uses the Wagner–Fischer algorithm in order to catch variations that you haven't thought of. If you use it in a project, please do tweet using the hashtag #isProfanity and I'll be sure to check it out.
[](https://www.npmjs.com/package/isprofanity)
[](https://www.npmjs.com/package/isprofanity)
## Installation
Installation is very simple due to isProfanity being on NPM. Simply type: `npm install isprofanity` from a console in the project directory then add ` var isprofanity = require('isprofanity');` to the top of your project file.
## Usage
There is only one function in isProfanity. Calling it is a simple as typing:
```javascript
isprofanity(s,function(t){
// t will equal true if it contains a swear word and false if not
});
```
's' being the string that you want to check for profanity and 't' being the boolian callback.
For a full example usage, you can try out the following code, setting 's' as a string that you would like to test.
```javascript
var s = "You absolute vanker";//misspelling of 'wanker' which would be allowed by most filters...
isprofanity(s ,function(t){
b = t ? 'contains' : 'does not contain';
console.log('"'+s+'" '+b+' profanity');
process.exit();
});
```
## Advance Usage
### Setting custom lists
IsProfanity also contains the abilty to pass custom csv files for both profanity and exceptions. You can do this like so:
```javascript
isprofanity(s,function(t){
// t will equal true if it contains a swear word and false if not
},'data/profanity.csv','data/exceptions.csv');
```
While an exceptions file is not needed to replace the profanity list, it is recomended as some words do get flagged that are not swear words. (A notable example in the default set is 'while').
Key note: Unfortunately, this cannot be done while running in browser mode due to the fact that the browser does not support `fs`.
### Change Sensitivity
IsProfanity does allow the changing of its sensitivity as of version 1.4.0. Changing the sensitivity will require you to use a custom exception list if using a setting higher than `0.67` ( the default) and as such **you can only use the default or decrease the sensitivity while not running in browser mode**. To change the sensitivity, try the following:
```javascript
var customSensitivity = 0.5;
isprofanity(s,function(t){
// t will equal true if it contains a swear word and false if not using your custom sensitivity
},'data/profanity.csv','data/exceptions.csv',customSensitivity);
```
**Warning: Using a custom sensitivity setting may allow more words through. For example, a sensitivity of `0.5` will still block** `f**k` **but will no longer block** `f***`.
### Get an array of the words that were blocked
I added this to help find exceptions although it could be useful in other cases too. In order to get this array, simply use the following:
```javascript
isprofanity(s,function(t,blocked){
// t will equal true if it contains potential profanity and false if not
// blocked will be an array of the blocked words, how sure it is about them and what word they are closest to.
});
```
If you find any false positives, please share them.
---
[](https://github.com/vandie/OcuCount/blob/master/LICENSE)
---
Follow me on twitter ([@MVD_Vandie](https://twitter.com/MVD_Vandie)) or on github in order to keep track of my projects and releases.
[](https://twitter.com/MVD_Vandie)
[](https://github.com/vandie)
Support me via Brave : https://brave.com/van441
Enjoy. :D