# @desertnet/html-parser 中文文档
规范地址：https://npmcn.com/package/%40desertnet/html-parser/
版本：1\.0\.1
npm 元数据更新时间：2022-06-12T17:01:35.999Z
中文译文更新时间：2026-11-12T01:10:33.278Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40desertnet/html-parser
原文对照：https://npmcn.com/package/%40desertnet/html-parser/?lang=original
项目主页：https://github.com/desertnet/html-parser#readme
源码仓库：https://github.com/desertnet/html-parser
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：463 kB，40 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2016-08-17T21:31:29.053Z
- 最新版本发布：2018-08-01T20:48:36.999Z
- 近 30 天下载量：8763（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）
## 中文简介
HTML 解析器和非限制性验证器
## 安装
```sh
npm install @desertnet/html-parser
```
也可以使用：`pnpm add @desertnet/html-parser`、`yarn add @desertnet/html-parser`、`bun add @desertnet/html-parser`
## README
# html-parser 软件
此 HTML 解析器和校验器不是 XHTML 严格校验器的静脉中严格的 HTML 解析器。 相反,它旨在像浏览器一样解析HTML,并且只解析可能混淆浏览器或显示HTML作者混淆的表面错误.
## 安装
```sh
npm install --save @desertnet/html-parser
```
## 使用量
```javascript
const HTMLParser = require('@desertnet/html-parser')
const html = `
I forgot to close my b tag.
I&npsb;misspelled the no-break-space entity.
`.trim()
const errors = HTMLParser.validate(html)
errors.forEach(error => {
console.log(`${error.message} (line: ${error.line}, column: ${error.column})`)
})
```
产出:
```
Could not find closing tag for "". (line: 2, column: 3)
Unexpected closing tag, "". Expected closing tag for "". (line: 3, column: 1)
Invalid HTML entity name for "&npsb;". (line: 6, column: 5)
```
## API 密码
### HTMLParser.validate( htmlString) (韩语)
静态方法 `HTMLParser` 建筑师。 解析 HTML 片段 `htmlString` 返回数组 `HTMLParseError`s. 如果没有出错,则返回空数组.
### HTML 辅助程序
这个 `HTMLParser` 建筑师。 不用争辩.
```javascript
const parser = new HTMLParser()
```
#### .parse (html String) (中文(简体) )
解析 HTML 片断 `htmlString` 返回一个 `HTMLNode` 包含已解析的 HTML 对象.
```javascript
const parseTree = parser.parse('Hello world!
')
```
### HTML 路径错误
代表发现的正在解析 HTML 片段的错误 .
```javascript
parseTree.errors.forEach(error => {
console.log(`${error.message} (line: ${error.line}, column: ${error.column})`)
})
```
#### . 信息
属性是包含对错误的英文描述的字符串 .
#### 启动Index
属性,指向开始错误的源字符串的索引数字.
#### 最终索引
属性是一个数字,指向结束错误的源字符串中的索引.
#### 线条
属性是表示开始错误的行号。 行号为 `1`没有 `0`。 。 。 .
#### .栏
属性是一个数字,表示开始错误的行的列。 列也开始于 `1`没有 `0`。 。 。 .
### HTML 节点
所有节点类型的基础类. 归来 `HTMLParser`是因为 `.parse` 方法.
```javascript
console.log(indentedNodeList(parseTree))
function indentedNodeList (node, indent = '') {
let str = ''
if (node.children) {
str += node.children.reduce((prev, child) => {
return prev + indentedNodeList(child, `${indent} `)
}, '')
}
return `${indent}${node.type}\n${str}`
}
```
#### 类型
显示节点类型的属性 。 这将是以下字符串之一:
- `ROOT`:树根节点.
- `TAG`: HTML 标记.
- `ATTRIBUTE`: HTML 标记的属性.
- `TEXT`:文本内容节点.
- `ENTITY`: HTML 实体(即:. `&`(中文(简体) )
- `COMMENT`: HTML 注释标记.
- `CLOSETAG`: 一个关闭的 HTML 标记.
#### 儿童
两者之一的财产 `null`,或数组 `HTMLNode`这是节点的孩子.
#### . 索引范围
属性, 如果非无, 将是两个数字的数组 。 第一种是节点开始地源字符串的索引,第二种是节点结束地源字符串的索引.
#### 错误
属性为 `HTMLParseError`s与此节点及其后人相关.
#### 上行错误
属性为 `HTMLParseError`s只与此节点相关(不是它的后人).
#### 标签Name
打开 `TAG` 财务报告和审定财务报表 `CLOSETAG` 类型节点,这是小写标签名的字符串.
#### 属性
打开 `TAG` 类型节点,这是一组 `ATTRIBUTE` 属于标记的节点.
#### 关闭标签
打开 `TAG` 类型节点,这是 `CLOSETAG` 节点,如果找到此节点的关闭标记 .
## 常见问题
### @desertnet/html-parser 是什么？
HTML 解析器和非限制性验证器
### 如何安装 @desertnet/html-parser？
在项目目录运行 npm install @desertnet/html-parser，或使用 pnpm add / yarn add / bun add。
### @desertnet/html-parser 支持 TypeScript 吗？
该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/desertnet\_\_html-parser 是否存在。
### @desertnet/html-parser 支持 ESM 还是 CommonJS？
以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。
### @desertnet/html-parser 可以商用吗？
@desertnet/html-parser 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @desertnet/html-parser 的下载量有多少？
根据 npm 官方下载统计，@desertnet/html-parser 在 2026/10/12 – 2026/11/10 这 30 天内被下载 8,763 次，日均约 292 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @desertnet/html-parser 还在维护吗？
最新版本 1\.0\.1 发布于 2018/08/02（8 年前）；至今共发布 2 个版本，其中过去 12 个月发布了 0 个；首次发布于 2016/08/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。