CustomEvent 构造函数必须传入 detail 对象才能被监听器可靠读取，否则 event.detail 为 undefined；派发前须确保目标元素已挂载且监听已注册，推荐向编辑器实例派发并用标准 addEventListener 监听。
CustomEvent 构造函数必须传入 detail 对象才能被监听器可靠读取
很多编辑器插件在初始化后需要通知宿主环境“我准备好了”，但直接 new CustomEvent('plugin-ready') 会导致监听方拿到的 event.detail 是 undefined——这不是 bug，是规范行为。浏览器要求自定义事件若要携带数据，必须显式传入 detail 字段。
实操建议：
立即学习“前端免费学习笔记（深入）”；
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 始终用
new CustomEvent('plugin-ready', { detail: { pluginId: 'markdown-preview', version: '2.1.0' } })形式构造，哪怕 detail 是空对象{} - 避免只写
new CustomEvent('plugin-ready')，否则监听端event.detail永远为undefined，容易引发空值错误 - 如果插件需传递 DOM 节点（如工具栏按钮），注意
detail中只能放可结构化克隆的数据；节点需转为 ID 或用WeakMap关联
派发事件前必须确保目标元素已挂载且支持 dispatchEvent
在编辑器初始化流程中，常有人在插件类构造函数里立刻 document.dispatchEvent()，结果监听器收不到——因为此时宿主页面可能还没执行到 addEventListener 注册逻辑，或目标元素（比如编辑器容器）尚未插入 DOM。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 优先向编辑器实例本身派发，例如
editorEl.dispatchEvent(event)，前提是editorEl是真实存在的 HTMLElement - 若必须全局广播，改用
window.dispatchEvent(event)，并确保监听方在DOMContentLoaded后注册 - 在插件
init()方法末尾、所有异步资源加载完成（如 CSS 注入、Worker 初始化）之后再派发，避免“假完成”信号
监听方需用 addEventListener 捕获冒泡阶段，且不能依赖 once: true
有些插件文档写“触发 plugin-ready 事件”，但使用者用 element.addEventListener('plugin-ready', handler, { once: true }) 却收不到——原因往往是事件派发早于监听注册，或监听目标与派发目标不一致。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 监听必须用标准形式：
editorEl.addEventListener('plugin-ready', handler)，不要加{ once: true }，除非你确定监听逻辑一定先于派发执行 - 如果监听的是
window，注意检查是否在load或DOMContentLoaded之后才绑定，否则会漏掉同步派发的事件 - 调试时可在监听回调里打日志，并检查
event.target是否符合预期（比如是#editor还是window），避免监听错对象
Vue/React 等框架环境下需绕过虚拟 DOM 直接操作真实节点
在 Vue 组件或 React 函数组件中，直接对 ref 元素调用 dispatchEvent 可能失败——因为框架可能尚未将 ref 绑定到真实 DOM，或事件被合成事件系统拦截。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- Vue 中使用
onMounted(() => { editorRef.value?.dispatchEvent(event) })，确保 DOM 已就绪 - React 中用
useEffect(() => { editorRef.current?.dispatchEvent(event) }, [])，且 ref 必须通过useRef+ref={editorRef}正确绑定 - 避免在框架的事件处理器（如
@click）里派发初始化事件，那属于用户交互时机，不是插件生命周期节点
detail 字段缺失导致监听方无法解构数据，以及派发目标与监听目标错位。这两个点不解决，信号就只是“发出去了”，而不是“被收到了”。 
