ITStudio_OUC/OxideJS-New
0
1
Fork 0
mirror of https://github.com/pjh456/OxideJS.git synced 2026-10-26 03:31:12 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat: MessageEvent 载荷盒加 GC 加构造器加原型加交付整合

Browse Source
This commit is contained in:
彭俊皓
2026-10-10 14:17:25 +00:00
parent 24a8baaf62
commit 1633512d5f
9 changed files with 631 additions and 97 deletions
Download Patch File Download Diff File Expand all files Collapse all files
crates/oxide_vm/src/worker/bindings.rs
+47 -20
View File
@@ -1,6 +1,6 @@
//! Worker API 的 concrete `&mut Vm` native 函数：构造器、`postMessage`/`terminate`
//! 原型方法、`self` 面（`self.postMessage`/`self.close`/`self.name`/`self.location`）
//! 与 `MessageEvent` 构造辅助。
//! 与 `MessageEvent` / 错误事件构造辅助。
//!
//! 关键约定：
//! - 函数是 concrete `&mut Vm` 形态（`NativeFn`），不挂 `VmHost` trait（trait 是单
@@ -287,30 +287,59 @@ pub(crate) fn self_location(vm: &mut Vm, _args: &[u8]) -> NativeResult {
NativeResult::Ok(vm.new_string(""))
}
/// 事件构造辅助：建真实 Event 盒（`type` 字段）加 `data` / `message` 普通属性。
/// 消息事件构造辅助：建真实 MessageEvent 盒（`data` + `type`，`ports` 空数组）。
///
/// 消息事件与错误事件同型，共用本辅助：消息事件 `message` 为 undefined，
/// 错误事件 `data` 为 undefined、`message` 为错误串。
/// 消息路径（`deliver_worker_messages` / `deliver_self_message`）经本辅助建
/// 真实 MessageEvent，`e instanceof MessageEvent` 与 `e instanceof Event` 均
/// 成立，`e.data` 经原型 getter 读盒字段。
///
/// # 步骤
/// 1. 经 `create_event_box` 建真实 Event 盒（`type` 取 `type_val` 的字符串形态，
/// `[[Prototype]]` → `Event.prototype`），使 `dispatchEvent` 品牌守卫通过。
/// 2. define `data` 属性（rehydrate 后的消息值，可枚举；GC 边）。
/// 3. `message` 非 undefined 时 define `message` 属性（错误消息串，可枚举）。
/// 4. 返回对象。
/// 1. 读 `data`（`args[1]`）与 `type`（`args[2]`）。
/// 2. 委托 `create_message_event_box` 建真实 MessageEvent 盒（`origin` 空串、
/// `lastEpoch` 0、`source` null、`ports` 空数组，`[[Prototype]]` →
/// `MessageEvent.prototype`），使 `dispatchEvent` 品牌守卫通过。
/// 3. 返回对象。
///
/// # 边界与前提
/// - `data` 是 rehydrate 后的消息值（GC 边，经属性区入 mark）。
/// - `type` 是事件类型串（`"message"`/`"error"`/`"messageerror"`）。
/// - `message` 是错误消息串（仅错误事件定义，消息事件为 undefined）。
/// - Event 盒无 `data` 字段（8.4 的 MessageEvent 才补），`data` 作盒对象普通属性。
/// - `data` 是 rehydrate 后的消息值（GC 边，经盒边入 mark）。
/// - `type` 是事件类型串（`"message"`）。
///
/// # 副作用
/// - 新建一个 Event 盒对象（经 `alloc_object` 入对象表）。
/// - 新建一个 MessageEvent 盒对象（经 `alloc_object` 入对象表）。
pub(crate) fn message_event_constructor(vm: &mut Vm, args: &[u8]) -> NativeResult {
let data_val = if args.len() > 1 { vm.reg(args[1]) } else { JsValue::undefined() };
let type_val = if args.len() > 2 { vm.reg(args[2]) } else { JsValue::undefined() };
let message_val = if args.len() > 3 { vm.reg(args[3]) } else { JsValue::undefined() };
// 建真实 MessageEvent 盒（type 取 type_val 的字符串形态）。
let type_text = vm.lookup_str(type_val).unwrap_or_default();
let ptr = oxide_builtins::event::create_message_event_box(vm, data_val, &type_text);
NativeResult::Ok(JsValue::from_js_object(ptr))
}
/// 错误事件构造辅助（临时形态）：建真实 Event 盒（`type` 字段）加 `data` /
/// `message` 普通属性。
///
/// 错误路径（`deliver_error_event`）经本辅助建错误事件：`data` 为 undefined、
/// `message` 为错误串，供 onerror 处理器读取。
///
/// # 步骤
/// 1. 读 `type`（`args[1]`）与 `message`（`args[2]`）。
/// 2. 经 `create_event_box` 建真实 Event 盒（`type` 取 `type_val` 的字符串
/// 形态，`[[Prototype]]` → `Event.prototype`），使 `dispatchEvent` 品牌守卫
/// 通过。
/// 3. define `data` 属性（undefined，可枚举）与 `message` 属性（错误消息串，
/// 可枚举）。
/// 4. 返回对象。
///
/// # 边界与前提
/// - `type` 是事件类型串（`"error"`/`"messageerror"`）。
/// - `message` 是错误消息串。
///
/// # 副作用
/// - 新建一个 Event 盒对象（经 `alloc_object` 入对象表）。
pub(crate) fn build_error_event(vm: &mut Vm, args: &[u8]) -> NativeResult {
let type_val = if args.len() > 1 { vm.reg(args[1]) } else { JsValue::undefined() };
let message_val = if args.len() > 2 { vm.reg(args[2]) } else { JsValue::undefined() };
// 建真实 Event 盒（type 取 type_val 的字符串形态）。
let type_text = vm.lookup_str(type_val).unwrap_or_default();
@@ -319,11 +348,9 @@ pub(crate) fn message_event_constructor(vm: &mut Vm, args: &[u8]) -> NativeResul
let event_obj = unsafe { &mut *ptr };
let si_data = vm.perm_intern("data");
let _ = vm.define_data_property(event_obj, si_data, data_val, PropAttributes::DEFAULT_DATA);
if !message_val.is_undefined() {
let si_message = vm.perm_intern("message");
let _ = vm.define_data_property(event_obj, si_message, message_val, PropAttributes::DEFAULT_DATA);
}
let _ = vm.define_data_property(event_obj, si_data, JsValue::undefined(), PropAttributes::DEFAULT_DATA);
let si_message = vm.perm_intern("message");
let _ = vm.define_data_property(event_obj, si_message, message_val, PropAttributes::DEFAULT_DATA);
NativeResult::Ok(JsValue::from_js_object(ptr))
}
crates/oxide_vm/src/worker/mod.rs
+39 -19
View File
@@ -318,8 +318,8 @@ impl Vm {
/// 2. 对每个 worker `poll_worker_messages` 排空通道（数据面 rehydrate 进主 realm）。
/// 3. 反查 Worker 对象（GC 根）。
/// 4. 错误面逐条交付 `onerror`；消息交付失败面逐条交付 `onmessageerror`。
/// 5. 数据面读 `onmessage` 属性，可调用时逐条建 MessageEvent 经
/// `execute_task` + `call_function_sync` 触发，后 `drain_microtasks`。
/// 5. 数据面逐条建真实 MessageEvent 经 `dispatchEvent` 交付（注册表查
/// 监听器），后 `drain_microtasks`。
///
/// # 返回值
/// 本轮是否交付了任何面（false 时调用方 1ms 轮询，避免忙等）。
@@ -368,7 +368,7 @@ impl Vm {
if self.worker_object(id).is_none() {
break;
}
let event = self.build_message_event(data, "message", None);
let event = self.build_message_event(data, "message");
self.dispatch_event_on(worker_obj, event);
self.drain_microtasks();
}
@@ -407,35 +407,55 @@ impl Vm {
/// # 副作用
/// - 触发监听器回调与微任务 drain。
fn deliver_error_event(&mut self, worker_obj: JsValue, event_type: &str, message: &str) {
let event = self.build_message_event(JsValue::undefined(), event_type, Some(message));
let event = self.build_error_event(event_type, message);
self.dispatch_event_on(worker_obj, event);
self.drain_microtasks();
}
/// 建事件对象（`data` + `type` + `message` 属性），委托 `message_event_constructor`
/// 构造辅助。消息事件 `message` 为 `None`（undefined），错误事件 `data` 为
/// undefined、`message` 为错误串。
/// 消息路径建事件对象：建真实 MessageEvent（`data` + `type`，`ports` 空
/// 数组），委托 `message_event_constructor` 构造辅助。
///
/// # 步骤
/// 1. `type` 与 `message` 串物化为 session 串（`message` 为 `None` 时 undefined）。
/// 2. `data` / `type` / `message` 写入寄存器 1 / 2 / 3，委托
/// `message_event_constructor`（按寄存器下标读取）建对象。
/// 1. `type` 串物化为 session 串。
/// 2. `data` / `type` 写入寄存器 1 / 2，委托 `message_event_constructor`
/// （按寄存器下标读取）建对象。
///
/// # 返回值
/// 新建的事件对象值（构造失败时返回错误对象值）。
///
/// # 副作用
/// - 新建一个事件对象（经 `alloc_object` 入对象表）。
fn build_message_event(&mut self, data: JsValue, type_str: &str, message: Option<&str>) -> JsValue {
/// - 新建一个 MessageEvent 盒对象（经 `alloc_object` 入对象表）。
fn build_message_event(&mut self, data: JsValue, type_str: &str) -> JsValue {
let type_val = self.new_string(type_str);
let message_val = match message {
Some(m) => self.new_string(m),
None => JsValue::undefined(),
};
self.set_reg(1, data);
self.set_reg(2, type_val);
self.set_reg(3, message_val);
match bindings::message_event_constructor(self, &[0, 1, 2, 3]) {
match bindings::message_event_constructor(self, &[0, 1, 2]) {
NativeResult::Ok(v) => v,
NativeResult::Err(e) => e,
// 构造辅助只建对象，不产生尾调用（防御臂，不可达）。
NativeResult::TailCall { .. } => JsValue::undefined(),
}
}
/// 错误路径建事件对象（临时形态）：建真实 Event 盒（`type` 字段）加
/// `data` / `message` 普通属性，委托 `build_error_event` 构造辅助。
///
/// # 步骤
/// 1. `type` 与 `message` 串物化为 session 串。
/// 2. `type` / `message` 写入寄存器 1 / 2，委托 `build_error_event`
/// （按寄存器下标读取）建对象。
///
/// # 返回值
/// 新建的事件对象值（构造失败时返回错误对象值）。
///
/// # 副作用
/// - 新建一个 Event 盒对象（经 `alloc_object` 入对象表）。
fn build_error_event(&mut self, type_str: &str, message: &str) -> JsValue {
let type_val = self.new_string(type_str);
let message_val = self.new_string(message);
self.set_reg(1, type_val);
self.set_reg(2, message_val);
match bindings::build_error_event(self, &[0, 1, 2]) {
NativeResult::Ok(v) => v,
NativeResult::Err(e) => e,
// 构造辅助只建对象，不产生尾调用（防御臂，不可达）。
@@ -478,7 +498,7 @@ impl Vm {
/// - 触发监听器回调与微任务 drain。
pub(crate) fn deliver_self_message(&mut self, value: MessageValue) {
let data = rehydrate_message(self, &value);
let event = self.build_message_event(data, "message", None);
let event = self.build_message_event(data, "message");
// 取 worker global 对象指针（Ref 守卫在语句块内消费，不跨 &mut 借用长存）。
let global_ptr = {
let session = self.realm.session.borrow();