⚠️ WARNING: The wordlist.json file contains explicit language, slurs, and other harmful content. View it at your own risk.
Overview
CensorCore is a lightweight JavaScript library for detecting explicit or inappropriate text using a centralized JSON wordlist.
It is designed for straightforward integration: include a single script tag and call one function within your message handling logic.
CensorCore is suitable for chat applications, comment systems, forms, or any environment where user‑generated text requires screening.
Features
- Zero configuration setup
- Shared JSON wordlist loaded from CDN
- Efficient whole‑word matching
- Minimal and predictable API
- No DOM modification or event interception
- Full control retained by the integrating developer
Installation
To install CensorCore, include the script tag in the <head> of your HTML file to ensure it loads before your application code:
<script src="https://cdn.jsdelivr.net/gh/DerrickRichard/CensorCore-Library@latest/CensorCore.js"></script>
The library will load after your code if you place it near the closing </html> tag, causing it to fail.
After the script loads, a global object named censor becomes available.
Make sure your internet connection allows loading scripts from the CDN:
cdn.jsdelivr.net.
Inside your message‑sending logic, add:
// Block explicit messages using the CensorCore library
if (censor.isBlocked(text)) {
alert("Message blocked: Inappropriate Content");
return;
}
Your full send function may look like this:
function sendMessage() {
const text = input.value;
// Block explicit messages using the CensorCore library
if (censor.isBlocked(text)) {
alert("Message blocked: Inappropriate Content");
return;
}
addMessage(text);
input.value = '';
input.focus();
}
You may also host the script locally:
<script src="path/to/CensorCore.js"></script>
This setup requires no additional configuration and works out of the box.
Usage
Call censor.isBlocked(text) before sending or processing a message.
function sendMessage() {
const text = input.value;
// Check if the message contains blocked words
if (censor.isBlocked(text)) {
alert("Message blocked: Inappropriate Content");
return; // Prevent sending the message
}
// Proceed with sending the message
addMessage(text);
}
Ensure you call censor.isBlocked(text) before sending or processing the message.
If it returns true, block the message and notify the user.
Wordlist Structure
CensorCore loads a JSON file structured by category:
{
"profanity": ["word1", "word2"],
"hate_speech": ["word3", "word4"],
"harassment": ["word5", "word6"]
}
All categories are automatically merged into a single internal list.
The wordlist is curated solely by Derrick Richard to ensure consistency and quality.
Community members cannot directly edit the list; requests may be submitted via the repository’s Discussions page.
API Reference
censor.isBlocked(text: string): boolean
Returns true if the provided text contains any banned words. Returns false otherwise.
Design Philosophy
CensorCore intentionally avoids modifying the host page’s DOM, intercepting events, or altering UI behavior.
Instead, it provides a clear and predictable function that developers can integrate into their own message‑handling logic.
This ensures transparency, stability, and compatibility across a wide range of applications.
About the Developer
CensorCore was created and is maintained by Derrick Richard, a high‑school developer focused on building practical, lightweight tools for the web.
He publishes weekly programming articles on dev.to.
More information is available on his personal profile:
https://derrickrichard.github.io/profile/
Versions
- v1.0.0: Initial release with basic filtering functionality and a basic JSON wordlist.
- v1.1.0: Faster and more dependable filtering engine. Preprocessed wordlist, improved matching, safer behavior before load, locked public API, and cleaner internal code.
License
Released under the MIT License.
CensorCore Repository