The ESDoc Integrate Test Plugin is an extension for the ESDoc documentation generator, designed to incorporate integration test information directly into generated API documentation. It identifies test files based on configurable patterns (e.g., `(spec|Test)\.js$`) and extracts relevant interfaces such as `describe`, `it`, and `context` from test frameworks like Mocha or Jest, embedding these examples alongside the code they test. The plugin's current stable version is 1.0.0. However, the broader ESDoc ecosystem, including this plugin, appears to be abandoned, with no significant development or maintenance activity since approximately 2020. This means it lacks support for modern JavaScript features, TypeScript, and recent Node.js versions, making it unsuitable for contemporary projects requiring up-to-date documentation tooling. Its key differentiator was its tight integration of testing context into API docs, a feature now often handled by more actively maintained tools through different mechanisms.
npm install esdoc-integrate-test-pluginNo compatibility data collected yet for this library.
This configuration snippet shows how to integrate the plugin into your ESDoc setup (typically in an `esdoc.json` file), specifying where your test files are located (`source`), which testing interfaces to recognize, and patterns for including/excluding test files.
Consider migrating to a more actively maintained documentation generator (e.g., JSDoc, TypeDoc, Docusaurus) that supports modern JavaScript and Node.js versions.
If absolutely necessary to use this plugin, you would need to run it in a very old Node.js environment (e.g., Node.js 6 or 8), which is not recommended for production or modern development workflows due to security and performance implications.
No dependency data recorded yet.