Web Worker下适配jQuery Terminal 无DOM无jQuery实现HTML实体转字符方案问询

核心改造原则 #

遵循最小改动要求，仅替换存在DOM依赖的逻辑，原有纯字符串处理的代码1:1保留，保证最终行为和原实现完全一致，不引入jsdom等第三方DOM实现。
首先拆解现有代码的依赖边界：

• safe()为纯正则字符串处理逻辑，无任何DOM/jQuery依赖，可直接在Web Worker中运行
• text()中调用的$.terminal.strip()本身为纯字符串逻辑（核心是匹配ANSI转义序列、终端控制字符），无DOM依赖，只需将其实现从jQuery Terminal源码中独立抽取即可
• 仅bare_text()中操作jQuery DOM的代码存在依赖问题，是唯一需要改造的部分

原DOM操作的等价行为 #

原代码中$('<span>' + safe(string) + '</span>').text()的实际可观测效果为：

1. 通过safe()转义所有<>&特殊字符，避免后续解析时识别出HTML标签
2. 对字符串中所有合法HTML实体（命名实体、数字实体）做解码，转换为对应Unicode字符
3. 所有尖括号内容均作为普通文本保留，不会被解析为HTML标签，完全匹配这套函数“实体转实际字符、标签当普通文本”的核心目标

可落地改造方案 #

方案1：纯字符串零依赖实现（完全无DOM代码，适配所有Web Worker环境） #

该方案完全不使用任何DOM相关能力，通过实现和浏览器DOM解析规则对齐的实体解码逻辑替换原有jQuery调用，可在任何Web Worker环境下运行，无兼容性问题：

1. 原封不动保留safe()函数：该函数本身无依赖，直接复用即可
2. 实现对齐浏览器行为的HTML实体解码函数：匹配全量WHATWG标准HTML实体、十进制/十六进制数字实体，按和DOM一致的规则解码为对应字符
3. 保留bare_text()原有的短路径优化（无&字符时直接返回原串，不做额外处理）
   改造后核心代码示例：

// 原safe函数完全保留，无改动
function safe(string) {
    if (!string.match(/[<>&]/)) {
        return string;
    }
    return string.replace(/&(?![^;]+;)/g, '&amp;')
        .replace(/>/g, '&gt;').replace(/</g, '&lt;');
}
// 纯字符串实体解码，和DOM行为1:1对齐
function decodeHtmlEntities(str) {
    const entityRegex = /&(?:#(\d+)|#x([0-9a-fA-F]+)|([a-zA-Z0-9]+));/g;
    // 挂载WHATWG标准HTML实体映射表，和浏览器解析规则完全一致
    const standardEntityMap = {/* 全量实体映射内容可直接复用WHATWG规范定义的标准表 */};
    return str.replace(entityRegex, (match, dec, hex, name) => {
        if (dec) {
            const code = parseInt(dec, 10);
            // 和DOM一致：超出Unicode范围的字符替换为U+FFFD
            return String.fromCodePoint(code > 0x10FFFF ? 0xFFFD : code);
        }
        if (hex) {
            const code = parseInt(hex, 16);
            return String.fromCodePoint(code > 0x10FFFF ? 0xFFFD : code);
        }
        if (name && standardEntityMap[name]) {
            return standardEntityMap[name];
        }
        // 未匹配的实体直接返回原串，和DOM行为一致
        return match;
    });
}
// 改造后的bare_text，无任何DOM/jQuery依赖
function bare_text(string) {
    if (!string.match(/&/)) {
        return string;
    }
    return decodeHtmlEntities(safe(string));
}
// 原text函数逻辑保留，仅将$.terminal.strip()实现内联，无jQuery依赖
function text(string) {
    const stripped = terminalStrip(string); // 直接引入jQuery Terminal中strip的纯正则实现
    return bare_text(stripped);
}

方案2：原生API最小改动实现（不使用第三方JS-DOM） #

如果运行环境支持Web Worker内的原生DOMParser（现代Chrome、Firefox已默认支持），可直接复用该浏览器内置API替换原有jQuery DOM操作，改动量最小，且不引入jsdom等第三方DOM库，符合要求：

// 初始化一次解析器即可
const parser = new DOMParser();
function bare_text(string) {
    if (!string.match(/&/)) {
        return string;
    }
    // 原逻辑等价：构造DOM节点、取textContent
    const doc = parser.parseFromString(`<span>${safe(string)}</span>`, 'text/html');
    return doc.body.textContent;
}

该方案的实体解析行为和原jQuery逻辑完全一致，无需额外维护实体映射表，适合支持Worker内DOMParser的运行环境。 #

老旧函数的简化思路 #

1. 收敛重复判断逻辑：原代码中多次对字符串做特殊字符判断，可将短路径优化（无特殊字符直接返回）收敛到处理链路最外层，减少重复正则匹配的开销。比如将bare_text()和safe()中重复的特殊字符判断合并，避免对同一字符串做多次扫描。
2. 优化正则匹配精度：原safe()函数中/&(?![^;]+;)/g的正则存在过度匹配问题——只要&后面跟着任意非分号序列+分号就判定为合法实体，不校验实体名的合法性。可和实体解码逻辑对齐，仅对真正符合规则的实体名跳过转义，减少不必要的转义操作。
3. 统一处理管道：将原有的“转义→DOM解析”的链路调整为纯字符串管道处理，移除所有和DOM相关的逻辑分支，让代码逻辑更清晰。
4. 移除全局依赖残留：将原依赖$.terminal.strip()的逻辑改为独立函数，完全移除对jQuery全局对象的引用，避免Web Worker环境中找不到全局对象的报错。

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