JavaScript--DOM-- .dispatchEvent(）派发事件

介绍

是 DOM API 中的一个方法，用于在节点上触发指定的事件。你可以使用这个方法来模拟用户交互或者通知代码中其他部分某些事情已经发生。

以下是 dispatchEvent 方法的基本用法：

• 创建事件对象。
• 初始化事件的属性（如果需要）。
• 将事件派发到目标节点。

创建和初始化事件
JavaScript 允许你创建不同类型的事件，例如 Event, CustomEvent, MouseEvent, KeyboardEvent 等。每种事件类型都可能有自己特定的初始化方法。对于自定义事件，你通常会使用 new CustomEvent() 构造函数。

示例：

javascript
// 创建一个简单的事件，不带任何额外数据
const simpleEvent = new Event('simple');

// 创建一个自定义事件，并传递一些附加数据
const customEvent = new CustomEvent('custom', {
    detail: { message: 'Hello, World!' }
});

派发事件
创建事件后，你可以通过调用在 DOM 节点上可用的 dispatchEvent 方法来派发它。该方法接受一个事件作为参数，将其派发到节点上。

// 获取 DOM 元素
const button = document.querySelector('button');

// 添加事件监听器
button.addEventListener('simple', () => {
    console.log('Simple event triggered!');
});

button.addEventListener('custom', (event) => {
    console.log('Custom event triggered with data:', event.detail.message);
});

// 派发事件
button.dispatchEvent(simpleEvent);  // 控制台输出: Simple event triggered!
button.dispatchEvent(customEvent); // 控制台输出: Custom event triggered with data: Hello, World!

注意事项
dispatchEvent 方法返回一个布尔值，如果事件是可取消的，并且至少一个事件处理程序调用了 event.preventDefault()，则返回 false；否则返回 true。
如果想要事件冒泡并可被取消，那么在创建时需要指定相应的选项。
在触发自定义事件时，可以在 detail 属性中传递任意数据。
使用场景
dispatchEvent 常用于以下场景：

测试：模拟用户操作来测试组件或页面的行为。
自定义事件：在应用程序的不同部分之间传递自定义数据和通知。
组件通信：允许从较低层级向上传递事件，实现组件或元素之间的解耦通信

问题

我在阅读threejs源码的时候，遇到了以下这段代码

scope.dispatchEvent({ type: propName + '-changed', value: value });

这和我见到的用法不同。
这个用法并不是标准 DOM API 的一部分。这可能出现在以下几种情况下：

• 自定义事件系统：scope 可能是参与了某种自定义事件系统或框架的对象，该系统接受普通对象作为事件并处理它们。例如，一些 JavaScript 库和框架（如 Node.js 中的 EventEmitter 或者前端框架）可能允许或要求你以这种方式触发事件。

• 封装的 dispatchEvent 方法：如果 scope 对象包装了原生的 dispatchEvent 方法，它可能会接收一个普通对象，然后内部创建一个 CustomEvent 实例，并将其派发。
  后来发现在threejs的源码文件core中有一个EventDispatcher.d.ts文件，
  应该是自定义了书写方式。