Tiptap中insertContentAt插入video节点失效问题求助

问题概述 #

我们实现了一个Tiptap的Video节点扩展，执行setVideo命令时已确认命令触发，但视频节点始终无法插入文档；结构完全类似的Audio扩展按相同逻辑执行却正常工作。

核心问题分析 #

对比Audio扩展与当前Video扩展的代码，发现三个关键问题：

1. parseHTML选择器使用HTML实体导致失效
   Video扩展的parseHTML配置中，选择器写为div.video-wrapper>video,video，这里的>是HTML实体符号，Tiptap的选择器解析器无法识别，导致插入的<video>元素无法被映射到对应的Tiptap节点类型。

2. 属性解析时的元素类型断言错误
   在src、controls等属性的parseHTML回调里，错误地将元素断言为HTMLSpanElement，而视频元素实际是HTMLVideoElement，类型不匹配会导致属性读取失败，节点无法正常初始化。

3. 命令声明与实现参数不匹配
   声明的toggleVideo命令要求传入src参数，但实际实现未接收该参数，虽然当前问题未涉及此命令，但可能影响命令注册的完整性，间接导致节点处理异常。

修复方案 #

1. 修正parseHTML选择器 #

将实体化的>替换为实际的>符号：

parseHTML() {
  return [
    {
      tag: "div.video-wrapper>video,video",
      getAttrs: (el: any) => ({
        src: (el as HTMLVideoElement).getAttribute("src"),
      }),
    },
  ];
},

2. 修正元素类型断言 #

把所有HTMLSpanElement替换为HTMLVideoElement，示例：

src: {
  default: null,
  parseHTML: (el: any) => (el as HTMLVideoElement).getAttribute("src"),
  renderHTML: (attrs: any) => ({ src: attrs.src }),
},
controls: {
  default: true,
  renderHTML: (attrs: any) => ({ controls: attrs.controls }),
  parseHTML: (el: any) => {
    const videoEl = el as HTMLVideoElement;
    if (videoEl.getAttribute("controls")) {
      return videoEl.getAttribute("controls");
    } else if (videoEl.hasAttribute("controls")) {
      return true;
    } else {
      return false;
    }
  },
},

3. 对齐toggleVideo命令参数 #

调整命令实现，匹配接口声明的参数（若不需要该参数可修改接口定义）：

toggleVideo:
  (src: string) =>
  ({ commands }) =>
    commands.toggleNode(this.name, "paragraph"),

4. 可选：改用insertNode提升可靠性 #

放弃插入HTML字符串的方式，直接创建Tiptap节点对象，避免HTML解析的潜在问题：

setVideo:
  (id, src, width = 640, height = 480, controls = true, controlslist = "nodownload", options) =>
  ({ commands, state }) => {
    return commands.insertNodeAt(state.selection, {
      type: this.name,
      attrs: {
        src,
        width,
        height,
        controls,
        controlslist,
        documentId: id,
        videoResolution: `${width}x${height}`
      }
    }, options);
  },

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