如何在JavaScript/React中调用htmlhint？CLI npm包转编程调用方案

我已经安装了htmlhint库，能通过CLI命令npx htmlhint src/test-file.html对HTML文件做代码检查并输出错误信息，示例输出如下：

/Users/filipsavic/Documents/Programming/BM/Raven/code/src/component-library/widgets/HtmlEditor/test.html
      L1 |<html><body><div>asd <p>qw <span></span></p></div></body></html>
          ^ Doctype must be declared first. (doctype-first)

Scanned 1 files, found 1 errors in 1 files (5 ms)

我希望在JavaScript/React文件里通过如下方式调用该库获取检查结果：

import htmlHint from 'htmlhint';

const parseRes = htmlHint('<html><body><span>some stuff...</span></body></html>');

请问该如何实现这个需求？是否存在通用方法把仅支持CLI的npm包转为可在JS程序中导入调用的形式？

一、直接使用htmlhint的程序调用能力 #

实际上htmlhint本身就支持代码内导入调用，并非只能用CLI。具体实现步骤如下：

1. 导入并配置规则
   默认情况下htmlhint会加载内置规则，你也可以自定义规则配置（格式和.htmlhintrc一致）：

import htmlhint from 'htmlhint';

// 可选：自定义检查规则
const customRules = {
  'doctype-first': 'error',
  'tag-pair': 'error'
};

// 加载自定义规则（用默认规则可跳过此步）
htmlhint.addRules(customRules);

2. 执行检查并获取结构化结果
   使用htmlhint.verify()方法传入HTML字符串和规则配置，就能得到包含错误详情的数组：

const htmlContent = '<html><body><span>some stuff...</span></body></html>';
// 第二个参数为规则配置，用默认规则可省略
const checkResults = htmlhint.verify(htmlContent, customRules);

// checkResults示例结构：
// [
//   {
//     line: 1,
//     col: 1,
//     message: 'Doctype must be declared first.',
//     rule: { id: 'doctype-first', description: '...' }
//   }
// ]
console.log(checkResults);

二、通用方法：将纯CLI包转为代码可调用形式 #

如果遇到确实仅提供CLI接口的npm包，可通过以下两种方式处理：

• 直接调用核心模块
  多数CLI包的核心逻辑会放在lib或src目录下，查看包的package.json的main字段，或直接浏览包内文件结构，找到暴露核心功能的模块导入调用。
• 通过child_process执行CLI命令
  用Node.js的child_process模块执行CLI命令，捕获输出后解析结果：

import { exec } from 'child_process';

exec('npx htmlhint src/test-file.html', (error, stdout, stderr) => {
  if (error) {
    console.error(`执行错误: ${error}`);
    return;
  }
  // 自行解析stdout中的字符串，提取错误信息
  console.log('检查输出:', stdout);
});

这种方式效率较低且需要处理字符串解析，优先推荐直接调用核心模块。

内容的提问来源于stack exchange，提问作者Filip Savic