retext plugin to check for potential bad words.
- What is this?
- When should I use this?
- Install
- Use
- API
- Data
- Messages
- Types
- Compatibility
- Related
- Contribute
- License
This package is a unified (retext) plugin to check for possible
profane or otherwise vulgar wording.
It uses cuss
for sureness.
You can use this plugin when you’re dealing with your own text and want to check for potential mistakes.
This package is ESM only. In Node.js (version 16+), install with npm:
npm install retext-profanities
In Deno with esm.sh
:
import retextProfanities from 'https://esm.sh/retext-profanities@8'
In browsers with esm.sh
:
<script type="module">
import retextProfanities from 'https://esm.sh/retext-profanities@8?bundle'
</script>
Say our document example.txt
contains:
He’s pretty set on beating your butt for sheriff.
…and our module example.js
contains:
import retextEnglish from 'retext-english'
import retextProfanities from 'retext-profanities'
import retextStringify from 'retext-stringify'
import {read} from 'to-vfile'
import {unified} from 'unified'
import {reporter} from 'vfile-reporter'
const file = await unified()
.use(retextEnglish)
.use(retextProfanities)
.use(retextStringify)
.process(await read('example.txt'))
console.error(reporter(file))
…then running node example.js
yields:
example.txt
1:33-1:37 warning Be careful with `butt`, it’s profane in some cases butt retext-profanities
⚠ 1 warning
This package has an export map with several entries for plugins in different languages:
retext-profanities/ar-latn
— Arabic (Latin-script)retext-profanities/en
— Englishretext-profanities/es
— Spanishretext-profanities/fr
— Frenchretext-profanities/it
— Italianretext-profanities/pt
— Portugueseretext-profanities/pt-pt
— Portuguese (Portugal)retext-profanities
— English
Each module exports the plugin retextProfanities
as
the default export.
Check for potential bad words.
options
(Options
, optional) — configuration
Transform (Transformer
).
Configuration (TypeScript type).
ignore
(Array<string>
, optional) — phrases not to warn aboutsureness
(0
,1
, or2
, default:0
) — minimum sureness to warn about, seecuss
See cuss
.
Each message is emitted as a VFileMessage
, with source
set
to 'retext-profanities'
, ruleId
to the normalized phrase, actual
to the
potential bad word, expected
to an empty array, and profanitySeverity
to
the cuss
severity of the phrase.
This package is fully typed with TypeScript.
It exports the additional type Options
.
Projects maintained by the unified collective are compatible with maintained versions of Node.js.
When we cut a new major release, we drop support for unmaintained versions of
Node.
This means we try to keep the current release line, retext-profanities@^8
,
compatible with Node.js 16.
retext-equality
— check possible insensitive, inconsiderate languageretext-passive
— check passive voiceretext-simplify
— check phrases for simpler alternatives
See contributing.md
in retextjs/.github
for ways
to get started.
See support.md
for ways to get help.
This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.