thisandagain / Washyourmouthoutwithsoap

washyourmouthoutwithsoap

A list of bad words in many languages.

washyourmouthoutwithsoap is a simple module that provides a list (or lists) of bad words in many languages as well as a simple string matching utility to check arbitrary strings for the existence of words on the list. The source (English) bad word list is based on Google's Bad Word List originally used in the "What Do You Love" project.

Basic Use

Getting the List of Supported Locales

const wash = require('washyourmouthoutwithsoap');
wash.supported(); // Returns an array of ISO 639-1  locale codes

Checking a String Against the Word List

const wash = require('washyourmouthoutwithsoap');
wash.check('en', 'The quick brown fox jumped over the lazy dog.'); // false
wash.check('en', 'The fox was a bit of an asshole.'); // true

Getting All Words for a Specified Locale

const wash = require('washyourmouthoutwithsoap');
wash.words('en'); // Returns an array of words for the specified locale

Available Languages

To Test

npm test

To Build

While this library requires zero dependencies to run, it does use a build process to generate the large lists of bad words for each language using Google Translate. This data can be regenerated or modified yourself, but you will need to get access to your own Google Cloud Platform credentials. Once setup, you can build via:

node bin/build.js path/to/credentials.json