Real profanity words banned by Google, extracted from their hidden API before shutdown. Now available as an easy-to-use Node.js library for content filtering.
npm install @coffeeandfun/google-profanity-words> A fun and developer-friendly profanity detection library brought to you by Coffee & Fun LLC ☕🎉
> Built and maintained with love by Robert James Gabriel 💻✨
 
---
Google Profanity Words is a Node.js library that helps you detect and filter out naughty language (in multiple languages!) from your apps or content. Whether you’re building a chat app, a comment section, or a game—this one’s your profanity-slaying sidekick.
Made by devs for devs. Maintained by Robert at Coffee & Fun ☕❤️
---
- 🌐 Multilingual support – English and Spanish out of the box. More coming soon!
- 🔁 Monthly updates – Stay fresh with the latest no-no words
- 💡 Easy to use API – Straightforward methods, async/await friendly
- 🔬 Tested with Jest – Fully covered and ready for production
- ⚡ Tiny & Fast – Minimal deps = speedy installs and performance
---
``bash`
npm install @coffeeandfun/google-profanity-words
---
`javascript
import { ProfanityEngine } from '@coffeeandfun/google-profanity-words';
// Default is English
const profanity = new ProfanityEngine();
// Español? You got it.
const profanityES = new ProfanityEngine({ language: 'es' });
// Check a single word
const isBad = await profanity.search('example');
// Or check a full sentence
const hasCurses = await profanity.hasCurseWords('This is a test sentence');
console.log(isBad, hasCurses); // true / false
`
---
Create a new profanity detector engine!
`javascript`
const profanity = new ProfanityEngine(); // Defaults to English
Or choose a specific language:
`javascript`
const spanishProfanity = new ProfanityEngine({ language: 'es' });
#### Options:
- language (string, optional): 'en'
- = English (default) 'es'
- = Spanish
- If a language isn’t available, it falls back to English.
---
Check a single word to see if it's naughty.
`javascript`
const isProfane = await profanity.search('heck');
console.log(isProfane); // true or false
---
Check a full sentence or phrase for profanity.
`javascript`
const result = await profanity.hasCurseWords('You silly goose');
console.log(result); // probably false, unless goose is banned now 🪿
---
Get the full list of bad words in the current language.
`javascript`
const badWords = await profanity.all();
console.log(badWords); // ['word1', 'word2', 'etc']
---
- Empty strings? We gotchu. Returns false.search()
- and hasCurseWords() are case-insensitive.
- Special characters and punctuation? No problem.
---
We've got testing covered like whipped cream on a latte ☕🎂
Run the default test suite:
`bash`
npm test
Or use more specific Jest commands:
`bashWatch mode (great for dev workflow)
npx jest --watch
Tests are located in the
directory and use the real profanity files, so you know it’s legit 👀✅---
🔀 Example Use Cases
$3
`js
async function filterInput(input) {
if (await profanity.hasCurseWords(input)) {
return '⚠️ Whoa there! Language, please.';
}
return input;
}
`---
$3
js
const en = new ProfanityEngine({ language: 'en' });
const es = new ProfanityEngine({ language: 'es' });const englishResult = await en.search('bad');
const spanishResult = await es.search('malo');
`---
🌍 Want to Contribute?
We love open source buddies 💛
$3
1. Fork it 🍴
2. Add a file to
named like fr.txt` for French---
Built by Robert James Gabriel and the good people at Coffee & Fun LLC. We make dev tools with accessibility, coffee, and good vibes in mind.
> Wanna support? Send a coffee our way or just spread the word! ☕🚀
---
MIT – because sharing is caring.
---
- 🐛 Report Bugs
- 💡 Join Discussions
- 📬 Email: support@coffeeandfun.com
---
Made with ☕, code, and a sprinkle of magic at Coffee & Fun LLC 💖