JavaScript创建自定义事件需用CustomEvent构造函数（可带detail数据）、dispatchEvent触发（支持元素或document广播）、addEventListener监听（通过e.detail获取数据），注意冒泡、取消及内存泄漏。
JavaScript 中创建和使用自定义事件很简单，核心是 CustomEvent 构造函数 + dispatchEvent 触发 + addEventListener 监听。
创建自定义事件
用 CustomEvent 构造函数创建事件对象，可传入事件名和配置对象，其中 detail 字段用来携带任意数据：
new CustomEvent('myEvent', { detail: { id: 123, msg: 'hello' } })-
detail可以是字符串、数字、对象、数组，甚至函数（注意跨 iframe 时函数会丢失） - 如果不需要传参，可省略配置对象：
new CustomEvent('myEvent')
触发自定义事件
调用目标元素（或 document、window）的 dispatchEvent 方法：
-
element.dispatchEvent(event)—— 元素上触发 -
document.dispatchEvent(event)—— 全局广播（适合跨组件通信） - 事件会按 DOM 冒泡规则向上冒泡（除非设置
bubbles: false） - 默认不取消冒泡，也不可被阻止（除非显式设置
cancelable: true）
监听自定义事件
用标准的 addEventListener 监听，事件名与创建时一致：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
element.addEventListener('myEvent', handler)- 回调函数中通过
e.detail获取传递的数据：e.detail.id、e.detail.msg - 支持捕获阶段监听：
element.addEventListener('myEvent', handler, true) - 记得在不需要时用
removeEventListener清理，避免内存泄漏
一个完整小例子
按钮点击后触发自定义事件，父容器监听并打印数据：
// 创建事件
const event = new CustomEvent('dataReady', {
detail: { user: 'Alice', score: 95 },
bubbles: true
});
// 触发（比如在按钮点击里）
document.getElementById('btn').addEventListener('click', () => {
document.body.dispatchEvent(event);
});
// 监听
document.body.addEventListener('dataReady', (e) => {
console.log('收到数据：', e.detail); // { user: 'Alice', score: 95 }
});
基本上就这些。不复杂但容易忽略细节，比如忘记传 detail 或没调用 dispatchEvent。
