retext plugin to check for passive voice.
This package is a unified (retext) plugin to check for the passive voice. It checks for certain verbs ('am'
, 'are'
, 'were'
, 'being'
, 'is'
, 'been'
, 'was'
, or 'be'
), followed by a word in list.js
.
You can opt-into this plugin when you’re dealing with content that might contain weak language, and have authors that can fix that content.
This package is ESM only. In Node.js (version 16+), install with npm:
npm install retext-passive
In Deno with esm.sh
:
import retextPassive from 'https://esm.sh/retext-passive@5'
In browsers with esm.sh
:
<script type="module"> import retextPassive from 'https://esm.sh/retext-passive@5?bundle' </script>
Say our document example.txt
contains:
He was withheld while we were being fed.
…and our module example.js
contains:
import retextEnglish from 'retext-english' import retextPassive from 'retext-passive' 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(retextPassive) .use(retextStringify) .process(await read('example.txt')) console.error(reporter(file))
…then running node example.js
yields:
example.txt 1:8-1:16 warning Unexpected use of the passive voice withheld retext-passive 1:37-1:40 warning Unexpected use of the passive voice fed retext-passive ⚠ 2 warnings
This package exports no identifiers. The default export is retextPassive
.
unified().use(retextPassive[, options])
Check for the passive voice.
options
(Options
, optional) — configurationTransform (Transformer
).
Configuration (TypeScript type).
ignore
(Array<string>
, optional) — phrases not to warn aboutEach message is emitted as a VFileMessage
on file
, with source
set to 'retext-passive'
, ruleId
to any word in list.js
, actual
to the unexpected phrase, and expected
to an empty array.
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-passive@^5
, compatible with Node.js 16.
retext-equality
— check possible insensitive, inconsiderate languageretext-profanities
— check for profane and vulgar wordingretext-simplify
— check phrases for simpler alternativesSee 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.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4