//! Event 基类行为面:`Event` 构造器(`new Event(type, init)`)、原型 getter //! (type / target / currentTarget / eventPhase / isTrusted / bubbles / //! cancelable / defaultPrevented / composed)与原型方法(preventDefault / //! stopPropagation / stopImmediatePropagation / composedPath)。 //! //! 事件载荷盒(type 串与九项状态位)存于对象 `native_fn` 槽,向 GC 家族表 //! 暴露 edges/size/drop 三自由函数。 use std::mem; use oxide_kernel::shape_forge::EMPTY_SHAPE_ID; use oxide_types::object::{JsObject, NativeFnPtr}; use oxide_types::value::JsValue; use oxide_runtime_api::{NativeResult, ProtoKind, VmHost}; /// Event 载荷盒:存于对象 `native_fn` 槽(`Box::into_raw`,realm 局部单线程)。 /// `r#type` 是事件类型串(GC 字符串边),`target` / `current_target` 是目标 /// 对象(GC 对象边,初始 null),其余为简单状态位。 struct EventInner { r#type: JsValue, target: JsValue, current_target: JsValue, event_phase: u32, is_trusted: bool, bubbles: bool, cancelable: bool, default_prevented: bool, propagation_stopped: bool, immediate_stopped: bool, composed: bool, } /// 取载荷盒指针:仅 Event 标签对象返回 `Some`,其余标签返回 `None`。 fn event_payload_ptr(obj: &JsObject) -> Option<*mut EventInner> { if !obj.is_event_obj() { return None; } obj.native_fn().map(|ptr| ptr.as_ptr() as *mut EventInner) } /// 收集 Event 的引用边(type 串边与 target / current_target 对象边)。 /// /// `target` / `current_target` 空窗口(构造期回填之前)为 null,边函数自守, /// 语义自含。 pub fn event_native_edges(obj: &JsObject) -> Vec { let Some(ptr) = event_payload_ptr(obj) else { return Vec::new(); }; if ptr.is_null() { return Vec::new(); } // SAFETY: ptr 指向有效载荷盒(槽位仅构造期写入、释放时置空),只读字段。 let inner = unsafe { &*ptr }; vec![inner.r#type, inner.target, inner.current_target] } /// 只读核算 Event 载荷盒字节(不释放)。 pub fn event_native_size(obj: &JsObject) -> u64 { let Some(ptr) = event_payload_ptr(obj) else { return 0; }; if ptr.is_null() { return 0; } mem::size_of::() as u64 } /// 释放 Event 载荷盒(`Box`),返回释放字节数。 /// /// 盒 drop 时 type / target / current_target 的 JsValue 边随盒释放(GC 已 /// 判定死对象);槽置空保证重复调用零释放(幂等)。 pub fn drop_event_native(obj: &mut JsObject) -> u64 { let bytes = event_native_size(obj); if bytes == 0 { return 0; } let Some(ptr) = event_payload_ptr(obj) else { return 0; }; // SAFETY: ptr 非空(event_native_size 已验证),Box::from_raw 恰好释放一次。 unsafe { drop(Box::from_raw(ptr)); } obj.set_native_fn(None); bytes } /// 解析 this 为 Event 载荷盒共享引用:非 Event 对象或无载荷盒返回 None。 /// /// # 注意事项 /// 返回引用按 `'a` 声称为存活,实际存活至载荷盒被 GC 释放;调用方须在无 GC /// 窗口的单 native 函数内消费,不得跨用户调用窗口持有。 fn event_inner_of<'a>(this_val: JsValue) -> Option<&'a EventInner> { if !this_val.is_object() { return None; } let obj_ptr = this_val.as_js_object_ptr(); if obj_ptr.is_null() { return None; } // SAFETY: this_val 已确认是对象值,obj_ptr 指向合法 JsObject。 let obj = unsafe { &*obj_ptr }; if !obj.is_event_obj() { return None; } let box_ptr = event_payload_ptr(obj)?; if box_ptr.is_null() { return None; } // SAFETY: box_ptr 指向有效载荷盒(构造期写入、释放时置空);'a 存活由 // 调用方「无 GC 窗口内消费」约定保证。 Some(unsafe { &*box_ptr }) } /// 解析 this 为 Event 载荷盒可变引用:非 Event 对象或无载荷盒返回 None。 /// /// # 注意事项 /// 返回引用按 `'a` 声称为存活,实际存活至载荷盒被 GC 释放;调用方须在无 GC /// 窗口的单 native 函数内消费,不得跨用户调用窗口持有。 fn event_inner_of_mut<'a>(this_val: JsValue) -> Option<&'a mut EventInner> { if !this_val.is_object() { return None; } let obj_ptr = this_val.as_js_object_ptr(); if obj_ptr.is_null() { return None; } // SAFETY: this_val 已确认是对象值,obj_ptr 指向合法 JsObject。 let obj = unsafe { &mut *obj_ptr }; if !obj.is_event_obj() { return None; } let box_ptr = event_payload_ptr(obj)?; if box_ptr.is_null() { return None; } // SAFETY: box_ptr 指向有效载荷盒(构造期写入、释放时置空);'a 存活由 // 调用方「无 GC 窗口内消费」约定保证。 Some(unsafe { &mut *box_ptr }) } /// Event 构造器:`new Event(type, init)`。 /// /// # 步骤 /// 1. 非构造形态(`!constructing_native`)抛 TypeError(HTML 规范只有 /// [[Construct]],无 [[Call]]) /// 2. type 经完整 ToString 转串;空串抛 SyntaxError /// 3. init 字典读 bubbles / cancelable / composed(缺省 false) /// 4. 建载荷盒入 receiver 的 `native_fn` 槽,置 type_tag /// 5. 返回 receiver /// /// # 边界与前提 /// - receiver(`args[0]`)是 VM 按构造器 prototype 新分配的对象,proto 已 /// 指向 %Event.prototype%; /// - init 缺省(undefined)或非对象时对应标志取 false。 /// /// # 副作用 /// - receiver 的 `native_fn` 槽写入载荷盒、`type_tag` 置 Event 标签。 pub fn event_constructor(vm: &mut H, args: &[u8]) -> NativeResult { if !vm.constructing_native() { return NativeResult::Err(crate::error::create_type_error(vm, "Event constructor requires new")); } let this_val = vm.reg(args[0]); if !this_val.is_object() { return NativeResult::Err(crate::error::create_type_error(vm, "Event constructor requires new")); } // type 经完整 ToString 转串(对象经 ToPrimitive,Symbol 抛 TypeError)。 let type_val = if args.len() > 1 { vm.reg(args[1]) } else { JsValue::undefined() }; let type_str = match oxide_runtime_api::to_string_full(type_val, vm) { Ok(s) => s, Err(_) => { if let Some(exc) = vm.take_uncaught_value() { return NativeResult::Err(exc); } return NativeResult::Err(crate::error::create_type_error(vm, "Cannot convert value to a string")); } }; if type_str.is_empty() { return NativeResult::Err(crate::error::create_syntax_error(vm, "The provided type is empty")); } // init 字典读 bubbles / cancelable / composed(缺省或非对象时取 false)。 let mut bubbles = false; let mut cancelable = false; let mut composed = false; if args.len() > 2 { let init_val = vm.reg(args[2]); if init_val.is_object() { let init_ptr = init_val.as_js_object_ptr(); // SAFETY: init_val 已确认是对象值,借用即时消费。 let init_obj = unsafe { &*init_ptr }; for (name, slot) in [("bubbles", &mut bubbles), ("cancelable", &mut cancelable), ("composed", &mut composed)] { let si = vm.perm_intern(name); match vm.ordinary_get(init_obj, si, init_val) { Ok(v) => *slot = oxide_runtime_api::to_boolean(v), Err(_) => { if let Some(exc) = vm.take_uncaught_value() { return NativeResult::Err(exc); } return NativeResult::Err(crate::error::create_type_error( vm, "Event init property getter failed", )); } } } } } // 建载荷盒入 receiver 的 native_fn 槽,置 Event 标签。 let type_js = vm.new_string(&type_str); let inner = Box::into_raw(Box::new(EventInner { r#type: type_js, target: JsValue::null(), current_target: JsValue::null(), event_phase: 0, is_trusted: false, bubbles, cancelable, default_prevented: false, propagation_stopped: false, immediate_stopped: false, composed, })); // SAFETY: receiver 不可调用,native_fn 存不透明 `Box` 指针, // 与 ArrayBuffer / RegExp 的类型化存储模式一致。 let obj = unsafe { &mut *this_val.as_js_object_ptr() }; obj.type_tag = JsObject::OBJ_TYPE_EVENT; obj.set_native_fn(Some(unsafe { NativeFnPtr::from_raw(inner as *const ()) })); NativeResult::Ok(this_val) } /// `Event.prototype.type`:返回事件类型串。 pub fn event_type_getter(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.type getter called on non-Event object", )); }; NativeResult::Ok(inner.r#type) } /// `Event.prototype.target`:返回事件目标对象(未派发时 null)。 pub fn event_target_getter(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.target getter called on non-Event object", )); }; NativeResult::Ok(inner.target) } /// `Event.prototype.currentTarget`:返回当前派发目标(未派发时 null)。 pub fn event_current_target_getter(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.currentTarget getter called on non-Event object", )); }; NativeResult::Ok(inner.current_target) } /// `Event.prototype.eventPhase`:返回派发阶段(0 未派发 / 1 捕获 / 2 目标 / 3 冒泡)。 pub fn event_phase_getter(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.eventPhase getter called on non-Event object", )); }; NativeResult::Ok(JsValue::int(inner.event_phase as i32)) } /// `Event.prototype.isTrusted`:返回是否由用户操作产生(引擎恒 false)。 pub fn event_is_trusted_getter(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.isTrusted getter called on non-Event object", )); }; NativeResult::Ok(JsValue::bool(inner.is_trusted)) } /// `Event.prototype.bubbles`:返回是否冒泡。 pub fn event_bubbles_getter(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.bubbles getter called on non-Event object", )); }; NativeResult::Ok(JsValue::bool(inner.bubbles)) } /// `Event.prototype.cancelable`:返回是否可取消。 pub fn event_cancelable_getter(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.cancelable getter called on non-Event object", )); }; NativeResult::Ok(JsValue::bool(inner.cancelable)) } /// `Event.prototype.defaultPrevented`:返回默认行为是否已被阻止。 pub fn event_default_prevented_getter(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.defaultPrevented getter called on non-Event object", )); }; NativeResult::Ok(JsValue::bool(inner.default_prevented)) } /// `Event.prototype.composed`:返回是否跨 Shadow DOM 边界。 pub fn event_composed_getter(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.composed getter called on non-Event object", )); }; NativeResult::Ok(JsValue::bool(inner.composed)) } /// `Event.prototype.preventDefault`:cancelable 时置 defaultPrevented。 pub fn event_prevent_default(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of_mut(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.preventDefault called on non-Event object", )); }; if inner.cancelable { inner.default_prevented = true; } NativeResult::Ok(JsValue::undefined()) } /// `Event.prototype.stopPropagation`:置传播停止标志。 pub fn event_stop_propagation(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of_mut(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.stopPropagation called on non-Event object", )); }; inner.propagation_stopped = true; NativeResult::Ok(JsValue::undefined()) } /// `Event.prototype.stopImmediatePropagation`:置传播停止与立即停止双标志。 pub fn event_stop_immediate_propagation(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(inner) = event_inner_of_mut(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.stopImmediatePropagation called on non-Event object", )); }; inner.propagation_stopped = true; inner.immediate_stopped = true; NativeResult::Ok(JsValue::undefined()) } /// `Event.prototype.composedPath`:返回事件传播路径(首版仅含 this 自身)。 pub fn event_composed_path(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let Some(_) = event_inner_of(this_val) else { return NativeResult::Err(crate::error::create_type_error( vm, "Event.prototype.composedPath called on non-Event object", )); }; // 首版:路径仅含 this 自身(完整传播路径由事件派发任务补全)。 let array_proto = JsValue::from_js_object(vm.builtin_proto(ProtoKind::ArrayProto)); let arr = vm.alloc_object(JsObject::new_array(EMPTY_SHAPE_ID, array_proto, 1)); // SAFETY: arr 是本函数刚分配的对象,存活且本段无别名。 unsafe { (*arr).set_prop_at(0, this_val); } NativeResult::Ok(JsValue::from_js_object(arr)) }