hello';
const document = parseDocument(html, { autofix: true });
console.log(nodeToString(document)); //=>
hello
```
## 类型
### 来源元素
包含源区域信息的增强的 HTML 元素 :
```typescript
type SourceElement = {
source: {
openTag: {
startIndex: number;
endIndex: number;
data: string;
name: string;
isSelfClosing: boolean;
};
closeTag: {
startIndex: number;
endIndex: number;
data: string;
name: string;
} | null;
attributes: Array<{
name: {
startIndex: number;
endIndex: number;
data: string;
};
value: {
startIndex: number;
endIndex: number;
data: string;
} | null;
quote: '"' | "'" | null | undefined;
source: {
startIndex: number;
endIndex: number;
data: string;
};
}>;
};
children: SourceChildNode[];
};
```
### 源文件
带有位置公用设施的强化文件:
```typescript
type SourceDocument = {
children: SourceChildNode[];
offsetToPosition(offset: number): { line: number; character: number };
};
```
## 工具函数
### 节点toString( 节点)
将解析的节点转换回其 HTML 字符串表示式.
```typescript
import { parseDocument, nodeToString } from '@ciolabs/htmlparser2-source';
const html = '
content
';
const document = parseDocument(html);
console.log(nodeToString(document)); // '
content
'
```
### 类型警卫
软件包导出几种类型的守护功能:
- `isTag(node)` - 检查节点是否是源元素
- `isText(node)` - 检查节点是否是一个文本节点
- `isComment(node)` - 检查节点是否是一个评论节点
- `isDocument(node)` - 检查节点是否是源文件
- `isCDATA(node)` - 检查节点是否是CDATA区段
- `isDirective(node)` - 检查节点是否是一个处理指令
- `isDoctype(node)` - 检查节点是否为 doctype 声明
## 常见问题
### @ciolabs/htmlparser2-source 是什么？
在 htmlparser2 周围打包器,将源范围信息添加到 AST
### 如何安装 @ciolabs/htmlparser2-source？
在项目目录运行 npm install @ciolabs/htmlparser2-source，或使用 pnpm add / yarn add / bun add。
### @ciolabs/htmlparser2-source 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @ciolabs/htmlparser2-source 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。
### @ciolabs/htmlparser2-source 可以商用吗？
@ciolabs/htmlparser2-source 使用 Apache-2\.0 WITH Commons-Clause 许可。声明的许可为 Apache-2\.0 WITH Commons-Clause，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。
### @ciolabs/htmlparser2-source 的下载量有多少？
根据 npm 官方下载统计，@ciolabs/htmlparser2-source 在 2026/10/10 – 2026/11/08 这 30 天内被下载 30,993 次，日均约 1,033 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @ciolabs/htmlparser2-source 还在维护吗？
最新版本 0\.0\.3 发布于 2025/10/30（1 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/09/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。