X-ray解析HTML为对象数组技巧-Golang学习网

），无法生成多节结果。

✅ 核心思路：DOM 预处理 + X-ray 后解析
借助 jsdom 构建内存 DOM，遍历所有

，将其及后续连续非-

兄弟节点（如

、

中。这样就把线性结构转化为多个具备明确父子关系的块级容器，X-ray 即可自然地对每个

执行对象映射。

以下是完整、健壮的实现方案（含错误处理与空值兼容）：

const { JSDOM } = require('jsdom');
const xray = require('x-ray')();

// 自定义 trim 过滤器（X-ray 默认不内置）
xray.filters({
  trim: (value) => typeof value === 'string' ? value.trim() : value
});

async function parseNonNestedSections(html, url = '') {
  const dom = new JSDOM(html);
  const doc = dom.window.document;

  // 步骤1：定位所有 h2，并按逻辑分组包裹
  const h2s = doc.querySelectorAll('article h2'); // 限定在 article 内更安全
  if (h2s.length === 0) return { pageTitle: '', sections: [] };

  // 创建临时根容器，避免污染 body
  const wrapper = doc.createElement('div');
  wrapper.innerHTML = doc.querySelector('article').innerHTML;

  // 重置 wrapper 内部引用
  const h2List = wrapper.querySelectorAll('h2');

  for (let i = 0; i < h2List.length; i++) {
    const h2 = h2List[i];
    const sectionDiv = doc.createElement('section'); // 语义化标签更佳

    // 移动 h2 到新 section
    sectionDiv.appendChild(h2);

    // 收集后续同级节点，直到下一个 h2 或 null
    let next = h2.nextElementSibling;
    while (next && next.tagName !== 'H2') {
      const toMove = next;
      next = next.nextElementSibling;
      sectionDiv.appendChild(toMove);
    }

    // 插入到 wrapper 中原位置（保持顺序）
    h2.parentNode.insertBefore(sectionDiv, h2);
    h2.remove(); // 清理已移动的 h2
  }

  // 步骤2：用 X-ray 解析预处理后的 HTML
  const processedHtml = wrapper.innerHTML;

  return new Promise((resolve, reject) => {
    xray(processedHtml, {
      pageTitle: 'h1 | trim',
      sections: xray('section', [{
        subtitle: 'h3 | trim',
        elements: xray('ul li', ['| trim']) // 返回字符串数组，自动过滤空值
      }])
    })((err, result) => {
      if (err) return reject(err);
      // 确保 elements 始终为数组（即使 ul 不存在）
      result.sections = result.sections.map(sec => ({
        subtitle: sec.subtitle || undefined,
        elements: Array.isArray(sec.elements) ? sec.elements : []
      }));
      resolve(result);
    });
  });
}

// 使用示例
const sampleHtml = `
  <h1>Page title</h1>
  <article>
    <h2 id="first">Title 1</h2>
    <h3>Subtitle 1</h3>
    <ul><li>Element 1</li><li>Element 2</li><li>Element 3</li></ul>
    <h2 id="second">Title 2</h2>
    <h3>Subtitle 2</h3>
    <h2 id="third">Title 3</h2>
    <h3>Subtitle 3</h3>
    <ul><li>Element 1</li><li>Element 2</li><li>Element 3</li></ul>
  </article>
`;

parseNonNestedSections(sampleHtml)
  .then(console.log)
  .catch(console.error);

? 关键注意事项：