use oxide_kernel::shape_forge::{ShapeForge, EMPTY_SHAPE_ID}; use oxide_kernel::string_forge::PermInterner; use oxide_types::object::{JsObject, PropAttributes, PropMetaEntry}; use oxide_types::private_key::is_private_name_key; use oxide_types::value::JsValue; use oxide_runtime_api::{NativeResult, VmHost}; fn is_integer_index(key: &str) -> bool { if key.is_empty() || key.len() > 1 && key.as_bytes()[0] == b'0' { return false; } key.bytes().all(|b| b.is_ascii_digit()) && key.parse::().unwrap_or(u64::MAX) < (1u64 << 32) - 1 } /// 收集对象全部自身属性(shape 链),按规范顺序排列:整数索引在前升序,其余保持插入序。 /// 数组元素区(整数下标)不在此列,调用方需另行枚举。 pub fn walk_own_keys(vm: &H, obj: &JsObject) -> Vec<(u32, u32)> { let mut keys: Vec<(u32, u32)> = Vec::new(); let shape_id = obj.shape_id(); let mut pos: u32 = 0; let mut shape_ids = Vec::new(); let mut cursor = Some(shape_id); while let Some(id) = cursor { if id == EMPTY_SHAPE_ID { break; } if let Some(shape) = vm.kernel_core().shape_forge().get_shape(id) { cursor = shape.parent; if shape.property_name != u32::MAX && !is_private_name_key(shape.property_name) { shape_ids.push(id); } } else { break; } } for id in shape_ids.iter().rev() { if let Some(shape) = vm.kernel_core().shape_forge().get_shape(*id) { if shape.property_name != 0 && !is_private_name_key(shape.property_name) { keys.push((shape.property_name, pos)); } } pos += 1; } keys.sort_by(|(a_si, _), (b_si, _)| { let a_str = vm.kernel_core().perm_interner().lookup(*a_si).unwrap_or(""); let b_str = vm.kernel_core().perm_interner().lookup(*b_si).unwrap_or(""); match (is_integer_index(a_str), is_integer_index(b_str)) { (true, true) => a_str.parse::().unwrap().cmp(&b_str.parse::().unwrap()), (true, false) => std::cmp::Ordering::Less, (false, true) => std::cmp::Ordering::Greater, (false, false) => std::cmp::Ordering::Equal, } }); keys } /// 字符串键是否为数组下标("0"~"4294967294",无前导零)。 fn array_index_of(vm: &H, key_si: u32) -> Option { let key = vm.kernel_core().perm_interner().lookup(key_si)?; if key.is_empty() || (key.len() > 1 && key.starts_with('0')) { return None; } key.parse::().ok() } /// 删除对象自身属性(字节码 delete 与 Reflect.deleteProperty 共用)。 /// /// 数组下标键在元素区(shape 链外),标记为 hole(值 undefined + hole meta), /// length 不变;命名属性经 shape 链重建移除。属性不可配置时返回 false。 /// /// # 步骤 /// 1. 数组下标元素:检查 configurable,`mark_hole_at` 标记为 hole /// 2. 命名属性:walk_own_keys 定位槽位,不可配置返回 false /// 3. 数组先保存元素区(值 + meta),重建命名属性后恢复元素区 /// /// # 边界与前提 /// - 键不在对象自身(含原型链属性)返回 true /// - 非 configurable 属性返回 false /// - `key_si` 须已 intern /// /// # 副作用 /// - 修改 obj 的 shape_id、属性表与 generation;数组元素区内容不变 /// /// # 注意事项 /// - 数组元素存在性以 `prop_meta_at` 的 hole 标记判定,删除后重新写入元素 /// 会自动清除 hole 标记恢复存在 pub fn delete_own_property(vm: &mut H, obj: &mut JsObject, key_si: u32) -> bool { // 数组下标元素在元素区,不参与 shape 链,单独删除(保持 length 不变)。 if obj.is_array() { if let Some(index) = array_index_of(vm, key_si) { if index < obj.array_prop_count { let meta = obj.prop_meta_at(index); // 已是 hole 视为不存在;非 configurable 不可删。 if meta.is_some_and(|m| m.is_hole()) { return true; } if meta.is_some_and(|m| !m.attributes.configurable()) { return false; } obj.mark_hole_at(index); obj.bump_generation(); return true; } return true; } } let keys = walk_own_keys(vm, obj); let Some((_, delete_pos)) = keys.iter().find(|(si, _)| *si == key_si).copied() else { return true; }; // delete_pos 是 shape 槽位;数组对象存储索引 = 元素数 + 槽位。 let delete_store = if obj.is_array() { obj.array_prop_count + delete_pos } else { delete_pos }; if obj .prop_meta_at(delete_store) .map(|meta| !meta.attributes.configurable()) .unwrap_or(false) { return false; } // 数组重建前保存元素区(值 + meta),重建后恢复到命名属性之前。 let saved_elements: Vec = if obj.is_array() { (0..obj.array_prop_count).map(|i| obj.get_prop_at(i)).collect() } else { Vec::new() }; let saved_element_meta: Option>> = if obj.is_array() { obj.prop_meta_vec().map(|meta| meta[..obj.array_prop_count as usize].to_vec()) } else { None }; let retained: Vec<(u32, JsValue, Option)> = keys .into_iter() .filter(|(_, pos)| *pos != delete_pos) .map(|(si, pos)| { let store = if obj.is_array() { obj.array_prop_count + pos } else { pos }; (si, obj.get_prop_at(store), obj.prop_meta_at(store)) }) .collect(); // 重建 shape 链与属性表(数组先清空,含元素区,随后恢复)。 obj.set_shape_id(EMPTY_SHAPE_ID); obj.clear_props(); for (si, value, meta) in retained { let shape = vm.kernel_core().shape_forge().make_shape(obj.shape_id(), si); obj.set_shape_id(shape); let pos = obj.push_prop(value); if let Some(meta) = meta { if meta.is_accessor { obj.set_accessor_meta(pos, meta.get, meta.set, meta.attributes); } else { obj.set_data_meta(pos, meta.attributes); } } } if obj.is_array() { let n = saved_elements.len(); obj.set_prop_count(n); for (i, val) in saved_elements.into_iter().enumerate() { obj.set_prop_at(i, val); } if let Some(saved_meta) = saved_element_meta { let meta = obj.ensure_prop_meta(); for (i, entry) in saved_meta.into_iter().enumerate() { if let Some(entry) = entry { meta[i] = Some(entry); } } } } obj.bump_generation(); true } /// JS `Object()` 构造逻辑:创建空对象(prototype 为 null,由 VM 补装内置原型)。 pub fn object_constructor(vm: &mut H, args: &[u8]) -> NativeResult { let val = if args.len() > 1 { vm.reg(args[1]) } else { JsValue::undefined() }; let object_proto = vm.session().builtin_world().object_proto.as_ptr() as *mut JsObject; // 对象参数原样返回;原始值参数创建对应 boxed 对象(规范 ToObject)。 if val.is_object() { return NativeResult::Ok(val); } if val.is_null() || val.is_undefined() { let obj = vm.alloc_object(JsObject::new_empty(EMPTY_SHAPE_ID, JsValue::from_js_object(object_proto))); return NativeResult::Ok(JsValue::from_js_object(obj)); } if val.is_int() || val.is_double() { let proto = vm.session().builtin_world().number_proto.as_ptr() as *mut JsObject; let obj = vm.alloc_object(JsObject::new_empty(EMPTY_SHAPE_ID, JsValue::from_js_object(proto))); let obj_ref = unsafe { &mut *obj }; obj_ref.type_tag = JsObject::OBJ_TYPE_NUMBER_OBJ; obj_ref.set_prop_at(0, val); return NativeResult::Ok(JsValue::from_js_object(obj)); } if val.is_string() { let proto = vm.session().builtin_world().string_proto.as_ptr() as *mut JsObject; let obj = vm.alloc_object(JsObject::new_empty(EMPTY_SHAPE_ID, JsValue::from_js_object(proto))); let obj_ref = unsafe { &mut *obj }; obj_ref.type_tag = JsObject::OBJ_TYPE_STRING_OBJ; obj_ref.set_prop_at(0, val); return NativeResult::Ok(JsValue::from_js_object(obj)); } if val.is_bool() { let proto = vm.session().builtin_world().boolean_proto.as_ptr() as *mut JsObject; let obj = vm.alloc_object(JsObject::new_empty(EMPTY_SHAPE_ID, JsValue::from_js_object(proto))); let obj_ref = unsafe { &mut *obj }; obj_ref.type_tag = JsObject::OBJ_TYPE_BOOLEAN_OBJ; obj_ref.set_prop_at(0, val); return NativeResult::Ok(JsValue::from_js_object(obj)); } let obj = vm.alloc_object(JsObject::new_empty(EMPTY_SHAPE_ID, JsValue::from_js_object(object_proto))); NativeResult::Ok(JsValue::from_js_object(obj)) } /// `Object.keys(obj)`:返回可枚举自身属性的字符串名数组。 pub fn object_keys(vm: &mut H, args: &[u8]) -> NativeResult { let obj_ptr = match require_obj_arg(vm, args, "keys") { Ok(ptr) => ptr, Err(err) => return NativeResult::Err(err), }; let key_names: Vec; { let obj = unsafe { &*obj_ptr }; let keys = walk_own_keys(vm, obj); let owned_keys: Vec<(u32, u32)> = keys .into_iter() .filter(|(_si, offset)| { obj.prop_meta_at(*offset) .map(|m| m.attributes.enumerable()) .unwrap_or(PropAttributes::DEFAULT_DATA.enumerable()) }) .collect(); key_names = owned_keys .iter() .map(|(si, _offset)| vm.kernel_core().perm_interner().lookup(*si).unwrap_or("").to_string()) .collect(); } let n = key_names.len(); let array_proto = vm.session().builtin_world().array_proto.as_ptr() as *mut JsObject; let arr = vm.alloc_object(JsObject::new_array( EMPTY_SHAPE_ID, JsValue::from_js_object(array_proto), n, vm.epoch().bump(), )); for (i, k) in key_names.iter().enumerate() { let str_val = vm.new_string(k); unsafe { (*arr).set_prop_at(i, str_val); } } unsafe { (*arr).set_prop_count(n); } NativeResult::Ok(JsValue::from_js_object(arr)) } /// `Object.create(proto, properties)`:以指定 prototype 创建新对象,可选地按 /// 属性描述符集合定义自身属性。 pub fn object_create(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.create: at least 1 argument required")); } let proto_val = vm.reg(args[1]); if proto_val.is_null() { let obj = vm.alloc_object(JsObject::new_empty(EMPTY_SHAPE_ID, JsValue::null())); if args.len() >= 3 && !vm.reg(args[2]).is_undefined() { if let Err(msg) = define_all_from_properties(vm, obj, vm.reg(args[2])) { return NativeResult::Err(crate::error::create_type_error(vm, &msg)); } } return NativeResult::Ok(JsValue::from_js_object(obj)); } if !proto_val.is_object() { return NativeResult::Err(crate::error::create_type_error( vm, "Object.create: prototype must be an object or null", )); } let obj = vm.alloc_object(JsObject::new_empty(EMPTY_SHAPE_ID, proto_val)); if args.len() >= 3 && !vm.reg(args[2]).is_undefined() { if let Err(msg) = define_all_from_properties(vm, obj, vm.reg(args[2])) { return NativeResult::Err(crate::error::create_type_error(vm, &msg)); } } NativeResult::Ok(JsValue::from_js_object(obj)) } /// `Object.assign(target, ...sources)`:拷贝各源对象的可枚举自身属性到目标,返回目标。 pub fn object_assign(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.assign requires a target")); } let target_val = vm.reg(args[1]); let target_val = match oxide_runtime_api::to_object(target_val, vm) { Ok(val) => val, Err(msg) => return NativeResult::Err(crate::error::create_type_error(vm, &msg)), }; let target_ptr = target_val.as_js_object_ptr(); if target_ptr.is_null() { return NativeResult::Ok(target_val); } let mut all_assignments: Vec<(u32, JsValue, JsValue)> = Vec::new(); for &arg_reg in args.iter().skip(2) { let source_val = vm.reg(arg_reg); if !source_val.is_object() { continue; } let source_ptr = source_val.as_js_object_ptr(); if source_ptr.is_null() { continue; } let source_keys: Vec<(u32, u32)> = { let source = unsafe { &*source_ptr }; walk_own_keys(vm, source) }; for (si, offset) in source_keys { let source = unsafe { &*source_ptr }; let val = source.get_prop_at(offset); all_assignments.push((si, source_val, val)); } } let target = unsafe { &mut *target_ptr }; for (si, source_val, val) in all_assignments { let promoted = vm.promote_if_needed_for_write_ptr(target_ptr, val); let _ = vm.ordinary_set(target, si, promoted, source_val); } NativeResult::Ok(target_val) } /// `Object.is(a, b)`:按 SameValue 语义比较(NaN 相等、+0/-0 不等)。 pub fn object_is(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 3 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.is called with insufficient arguments")); } let lhs = vm.reg(args[1]); let rhs = vm.reg(args[2]); NativeResult::Ok(JsValue::bool(oxide_runtime_api::same_value(lhs, rhs))) } /// 按 ToPropertyDescriptor 语义把描述符定义/修改到对象的自身属性上。 /// /// 处理数据(value/writable)与访问器(get/set)两类描述符;描述符字段沿原型 /// 链解析(ordinary_get,触发 accessor getter);字段缺失时按已有属性回填, /// 新属性缺省字段为 false。 /// /// # 步骤 /// 1. 解析 value/get/set/writable/enumerable/configurable 字段 /// 2. 校验 data 与 accessor 字段互斥、getter/setter 可调用 /// 3. 按访问器/数据/无字段三种形态调用对应 define 操作 /// /// # 边界与前提 /// - `desc_val` 必须是对象;`key_si` 须已 intern /// - 修改已有属性时缺省字段回填现有值;新属性缺省为 false /// /// # 副作用 /// - 修改 obj 的 shape 链、属性表与 generation fn define_from_descriptor( vm: &mut H, obj_ptr: *mut JsObject, key_si: u32, desc_val: JsValue, ) -> Result<(), String> { if !desc_val.is_object() { return Err("Property description must be an object".to_string()); } let value_si = vm.kernel_core().perm_interner().intern("value").0; let get_si = vm.kernel_core().perm_interner().intern("get").0; let set_si = vm.kernel_core().perm_interner().intern("set").0; let writable_si = vm.kernel_core().perm_interner().intern("writable").0; let enumerable_si = vm.kernel_core().perm_interner().intern("enumerable").0; let configurable_si = vm.kernel_core().perm_interner().intern("configurable").0; let value_field = own_field(vm, desc_val, value_si); let get_field = own_field(vm, desc_val, get_si); let set_field = own_field(vm, desc_val, set_si); let writable_field = own_field(vm, desc_val, writable_si); let existing_pos = { let obj = unsafe { &*obj_ptr }; vm.get_own_property_slot(obj, key_si) }; let existing_meta = existing_pos.and_then(|pos| { let obj = unsafe { &*obj_ptr }; obj.prop_meta_at(pos) }); // 修改已有属性时缺省字段回填现有值,仅定义新属性时缺省才为 false。 let enumerable = own_field(vm, desc_val, enumerable_si) .map(oxide_runtime_api::to_boolean) .unwrap_or_else(|| existing_meta.map(|m| m.attributes.enumerable()).unwrap_or(false)); let configurable = own_field(vm, desc_val, configurable_si) .map(oxide_runtime_api::to_boolean) .unwrap_or_else(|| existing_meta.map(|m| m.attributes.configurable()).unwrap_or(false)); let has_data = value_field.is_some() || writable_field.is_some(); let has_accessor = get_field.is_some() || set_field.is_some(); if has_data && has_accessor { return Err("Invalid property descriptor: cannot mix data and accessor fields".to_string()); } let existing_value = existing_pos.map_or(JsValue::undefined(), |pos| { let obj = unsafe { &*obj_ptr }; obj.get_prop_at(pos) }); let obj = unsafe { &mut *obj_ptr }; if has_accessor { let get = get_field.unwrap_or_else(|| { existing_meta .filter(|m| m.is_accessor) .map(|m| m.get) .unwrap_or(JsValue::undefined()) }); let set = set_field.unwrap_or_else(|| { existing_meta .filter(|m| m.is_accessor) .map(|m| m.set) .unwrap_or(JsValue::undefined()) }); if (!get.is_undefined() && !is_callable(get)) || (!set.is_undefined() && !is_callable(set)) { return Err("accessor descriptor get/set must be callable or undefined".to_string()); } vm.define_accessor_property(obj, key_si, get, set, PropAttributes::new(false, enumerable, configurable))?; } else if has_data { let value = if existing_pos.is_some() { value_field.unwrap_or(existing_value) } else { value_field.unwrap_or(JsValue::undefined()) }; let writable = if existing_pos.is_some() { writable_field .map(oxide_runtime_api::to_boolean) .unwrap_or_else(|| existing_meta.map(|m| m.attributes.writable()).unwrap_or(false)) } else { writable_field.map(oxide_runtime_api::to_boolean).unwrap_or(false) }; vm.define_data_property(obj, key_si, value, PropAttributes::new(writable, enumerable, configurable))?; } else { if existing_pos.is_none() { vm.define_data_property( obj, key_si, JsValue::undefined(), PropAttributes::new(false, enumerable, configurable), )?; return Ok(()); } let is_accessor = existing_meta.map(|m| m.is_accessor).unwrap_or(false); let writable = existing_meta.map(|m| m.attributes.writable()).unwrap_or(true); let attrs = PropAttributes::new(writable, enumerable, configurable); if is_accessor { let get = existing_meta.map(|m| m.get).unwrap_or(JsValue::undefined()); let set = existing_meta.map(|m| m.set).unwrap_or(JsValue::undefined()); vm.define_accessor_property(obj, key_si, get, set, attrs)?; } else { vm.define_data_property(obj, key_si, existing_value, attrs)?; } } Ok(()) } /// 遍历对象自身的可枚举属性,把每个值当作描述符依次定义到目标对象上。 /// `Object.defineProperties` 与 `Object.create(proto, properties)` 共用。 /// /// # 边界与前提 /// - `props_val` 必须是对象,否则返回错误(null 触 ToObject 抛 TypeError) /// - 仅处理可枚举自身属性;描述符值经 ordinary_get 读取(触发访问器 getter) /// /// # 副作用 /// - 修改 target 的 shape 链、属性表与 generation fn define_all_from_properties( vm: &mut H, target_ptr: *mut JsObject, props_val: JsValue, ) -> Result<(), String> { if !props_val.is_object() { return Err("Property description must be an object".to_string()); } let props_ptr = props_val.as_js_object_ptr(); if props_ptr.is_null() { return Err("Property description must be an object".to_string()); } let prop_keys: Vec<(u32, u32)> = { let props = unsafe { &*props_ptr }; walk_own_keys(vm, props) }; for (key_si, offset) in prop_keys { let props = unsafe { &*props_ptr }; // 非可枚举自身属性跳过;无显式 meta 视为可枚举(普通字面量默认)。 if props .prop_meta_at(offset) .map(|m| !m.attributes.enumerable()) .unwrap_or(false) { continue; } let desc_val = vm.ordinary_get(props, key_si, props_val)?; define_from_descriptor(vm, target_ptr, key_si, desc_val)?; } Ok(()) } /// `Object.defineProperty(obj, key, descriptor)`:按 descriptor 定义/修改属性, /// 支持数据与访问器描述符,兼容已有属性的默认回填。 pub fn object_define_property(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 4 { return NativeResult::Err(crate::error::create_type_error( vm, "Object.defineProperty: expected at least 3 arguments", )); } let obj_val = vm.reg(args[1]); if !obj_val.is_object() { return NativeResult::Err(crate::error::create_type_error(vm, "Object.defineProperty called on non-object")); } let obj_ptr = obj_val.as_js_object_ptr(); if obj_ptr.is_null() { return NativeResult::Err(crate::error::create_type_error(vm, "Object.defineProperty called on non-object")); } // well-known symbol 等特殊键统一走 property_key_si(映射到 @@iterator 等别名), // 保证与计算属性访问、Reflect.defineProperty 等读键路径一致。 let si = vm.property_key_si(vm.reg(args[2])); if let Err(msg) = define_from_descriptor(vm, obj_ptr, si, vm.reg(args[3])) { return NativeResult::Err(crate::error::create_type_error(vm, &msg)); } NativeResult::Ok(obj_val) } /// `Object.getOwnPropertyDescriptor(obj, key)`:返回自身属性的描述符对象; /// 不存在返回 undefined。 pub fn object_get_own_property_descriptor(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 3 { return NativeResult::Err(crate::error::create_type_error( vm, "Object.getOwnPropertyDescriptor called on non-object", )); } let obj_val = vm.reg(args[1]); if !obj_val.is_object() { return NativeResult::Ok(JsValue::undefined()); } let obj_ptr = obj_val.as_js_object_ptr(); if obj_ptr.is_null() { return NativeResult::Ok(JsValue::undefined()); } let prop_name_str = oxide_runtime_api::to_string(vm.reg(args[2])); let si = vm.kernel_core().perm_interner().intern(&prop_name_str).0; let (found_value, found_meta, found) = { let obj = unsafe { &*obj_ptr }; let keys = walk_own_keys(vm, obj); let mut found_value = JsValue::undefined(); let mut found_meta = None; let mut found = false; for (prop_si, offset) in keys { if prop_si == si { found_value = obj.get_prop_at(offset); found_meta = obj.prop_meta_at(offset); found = true; break; } } (found_value, found_meta, found) }; if !found { return NativeResult::Ok(JsValue::undefined()); } let sf_ptr = vm.kernel_core().perm_interner().as_ref() as *const PermInterner; let sh_ptr = vm.kernel_core().shape_forge().as_ref() as *const ShapeForge; let desc_proto = vm.session().builtin_world().object_proto.as_ptr() as *mut JsObject; let desc = vm .epoch() .alloc(JsObject::new_empty(EMPTY_SHAPE_ID, JsValue::from_js_object(desc_proto))); let sf = unsafe { &*sf_ptr }; let sh = unsafe { &*sh_ptr }; let d: &mut JsObject = unsafe { &mut *desc }; let meta = found_meta.unwrap_or_else(|| oxide_types::object::PropMetaEntry::data(PropAttributes::DEFAULT_DATA)); if meta.is_accessor { push_desc_prop(d, sh, sf.intern("get").0, meta.get); push_desc_prop(d, sh, sf.intern("set").0, meta.set); push_desc_prop(d, sh, sf.intern("enumerable").0, JsValue::bool(meta.attributes.enumerable())); push_desc_prop(d, sh, sf.intern("configurable").0, JsValue::bool(meta.attributes.configurable())); } else { push_desc_prop(d, sh, sf.intern("value").0, found_value); push_desc_prop(d, sh, sf.intern("writable").0, JsValue::bool(meta.attributes.writable())); push_desc_prop(d, sh, sf.intern("enumerable").0, JsValue::bool(meta.attributes.enumerable())); push_desc_prop(d, sh, sf.intern("configurable").0, JsValue::bool(meta.attributes.configurable())); } NativeResult::Ok(JsValue::from_js_object(desc)) } /// 按 ToPropertyDescriptor 语义取描述符字段:沿原型链判存在性,存在时经 /// ordinary_get 取值(触发 accessor getter,receiver 为描述符对象本身)。 fn own_field(vm: &mut H, desc: JsValue, prop_si: u32) -> Option { // ordinary_get 对缺失属性返回 undefined,无法区分"不存在"与"值为 // undefined",故先用 resolve_property 沿原型链判 HasProperty。 let obj = unsafe { &*desc.as_js_object_ptr() }; vm.resolve_property(obj, prop_si)?; vm.ordinary_get(obj, prop_si, desc).ok() } fn is_callable(value: JsValue) -> bool { value.is_object() && unsafe { &*value.as_js_object_ptr() }.is_function() } fn push_desc_prop(obj: &mut JsObject, shape_forge: &ShapeForge, prop_si: u32, val: JsValue) { let shape_id = shape_forge.make_shape(obj.shape_id(), prop_si); obj.set_shape_id(shape_id); obj.push_prop(val); } fn require_obj_arg(vm: &mut H, args: &[u8], fn_name: &str) -> Result<*mut JsObject, JsValue> { if args.len() < 2 { return Err(crate::error::create_type_error(vm, &format!("Object.{fn_name} called on non-object"))); } let val = vm.reg(args[1]); if !val.is_object() { return Err(crate::error::create_type_error(vm, &format!("Object.{fn_name} called on non-object"))); } let ptr = val.as_js_object_ptr(); if ptr.is_null() { return Err(crate::error::create_type_error(vm, &format!("Object.{fn_name} called on non-object"))); } Ok(ptr) } macro_rules! native_try { ($expr:expr) => { match $expr { Ok(value) => value, Err(err) => return NativeResult::Err(err), } }; } /// `Object.freeze(obj)`:冻结对象(不可扩展 + 全部属性不可配置/不可写),返回原对象。 pub fn object_freeze(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.freeze called on non-object")); } let val = vm.reg(args[1]); if !val.is_object() || val.as_js_object_ptr().is_null() { return NativeResult::Ok(val); } let obj_ptr = val.as_js_object_ptr(); unsafe { (*obj_ptr).set_frozen(true); (*obj_ptr).set_extensible(false); } NativeResult::Ok(val) } /// `Object.seal(obj)`:密封对象(不可扩展 + 全部属性不可配置),返回原对象。 pub fn object_seal(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.seal called on non-object")); } let val = vm.reg(args[1]); if !val.is_object() || val.as_js_object_ptr().is_null() { return NativeResult::Ok(val); } let obj_ptr = val.as_js_object_ptr(); unsafe { (*obj_ptr).set_sealed(true); (*obj_ptr).set_extensible(false); } NativeResult::Ok(val) } /// `Object.preventExtensions(obj)`:禁止添加新属性,返回原对象。 pub fn object_prevent_extensions(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.preventExtensions called on non-object")); } let val = vm.reg(args[1]); if !val.is_object() || val.as_js_object_ptr().is_null() { return NativeResult::Ok(val); } let obj_ptr = val.as_js_object_ptr(); unsafe { (*obj_ptr).set_extensible(false); } NativeResult::Ok(val) } /// `Object.isFrozen(obj)`:对象是否冻结(检查 extensible 及全部属性 writable/configurable)。 pub fn object_is_frozen(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.isFrozen called on non-object")); } let val = vm.reg(args[1]); if !val.is_object() { return NativeResult::Ok(JsValue::bool(true)); } let obj_ptr = val.as_js_object_ptr(); if obj_ptr.is_null() { return NativeResult::Ok(JsValue::bool(true)); } let obj = unsafe { &*obj_ptr }; if obj.is_frozen() { return NativeResult::Ok(JsValue::bool(true)); } if obj.is_extensible() { return NativeResult::Ok(JsValue::bool(false)); } let keys = walk_own_keys(vm, obj); for (_si, offset) in keys { if let Some(meta) = obj.prop_meta_at(offset) { if meta.attributes.configurable() { return NativeResult::Ok(JsValue::bool(false)); } if !meta.is_accessor && meta.attributes.writable() { return NativeResult::Ok(JsValue::bool(false)); } } else { return NativeResult::Ok(JsValue::bool(false)); } } NativeResult::Ok(JsValue::bool(true)) } /// `Object.isSealed(obj)`:对象是否密封(检查 extensible 及全部属性 configurable)。 pub fn object_is_sealed(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.isSealed called on non-object")); } let val = vm.reg(args[1]); if !val.is_object() { return NativeResult::Ok(JsValue::bool(true)); } let obj_ptr = val.as_js_object_ptr(); if obj_ptr.is_null() { return NativeResult::Ok(JsValue::bool(true)); } let obj = unsafe { &*obj_ptr }; if obj.is_sealed() { return NativeResult::Ok(JsValue::bool(true)); } if obj.is_extensible() { return NativeResult::Ok(JsValue::bool(false)); } let keys = walk_own_keys(vm, obj); for (_si, offset) in keys { if let Some(meta) = obj.prop_meta_at(offset) { if meta.attributes.configurable() { return NativeResult::Ok(JsValue::bool(false)); } } else { return NativeResult::Ok(JsValue::bool(false)); } } NativeResult::Ok(JsValue::bool(true)) } /// `Object.isExtensible(obj)`:对象是否可扩展。 pub fn object_is_extensible(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.isExtensible called on non-object")); } let val = vm.reg(args[1]); if !val.is_object() { return NativeResult::Ok(JsValue::bool(false)); } let obj_ptr = val.as_js_object_ptr(); if obj_ptr.is_null() { return NativeResult::Ok(JsValue::bool(false)); } let obj = unsafe { &*obj_ptr }; NativeResult::Ok(JsValue::bool(obj.is_extensible())) } /// `Object.getOwnPropertyNames(obj)`:返回全部自身属性名(含不可枚举)。 pub fn object_get_own_property_names(vm: &mut H, args: &[u8]) -> NativeResult { let obj_ptr = native_try!(require_obj_arg(vm, args, "getOwnPropertyNames")); let key_names: Vec = { let obj = unsafe { &*obj_ptr }; let keys = walk_own_keys(vm, obj); keys.iter() .map(|(si, _)| vm.kernel_core().perm_interner().lookup(*si).unwrap_or("").to_string()) .collect() }; let n = key_names.len(); let array_proto = vm.session().builtin_world().array_proto.as_ptr() as *mut JsObject; let arr = vm.alloc_object(JsObject::new_array( EMPTY_SHAPE_ID, JsValue::from_js_object(array_proto), n, vm.epoch().bump(), )); for (i, k) in key_names.iter().enumerate() { let str_val = vm.new_string(k); unsafe { (*arr).set_prop_at(i, str_val); } } unsafe { (*arr).set_prop_count(n); } NativeResult::Ok(JsValue::from_js_object(arr)) } /// `Object.defineProperties(obj, descriptors)`:批量按描述符定义属性,返回目标对象。 pub fn object_define_properties(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 3 { return NativeResult::Err(crate::error::create_type_error( vm, "Object.defineProperties: expected at least 2 arguments", )); } let target_val = vm.reg(args[1]); let target_ptr = match require_obj_arg(vm, args, "defineProperties") { Ok(ptr) => ptr, Err(err) => return NativeResult::Err(err), }; if let Err(msg) = define_all_from_properties(vm, target_ptr, vm.reg(args[2])) { return NativeResult::Err(crate::error::create_type_error(vm, &msg)); } NativeResult::Ok(target_val) } /// `Object.fromEntries(entries)`:由 `[key, value]` 对数组构建对象。 pub fn object_from_entries(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Err(crate::error::create_type_error(vm, "Object.fromEntries: expected 1 argument")); } let entries = vm.reg(args[1]); if !entries.is_object() { return NativeResult::Err(crate::error::create_type_error(vm, "Object.fromEntries: argument must be iterable")); } let entries_ptr = entries.as_js_object_ptr(); if entries_ptr.is_null() { return NativeResult::Err(crate::error::create_type_error(vm, "Object.fromEntries: argument must be iterable")); } let obj = vm.alloc_object(JsObject::new_empty( EMPTY_SHAPE_ID, JsValue::from_js_object(vm.session().builtin_world().object_proto.as_ptr() as *mut JsObject), )); let target_val = JsValue::from_js_object(obj); let n: usize = unsafe { (*entries_ptr).prop_vec_len() }; for i in 0..n { let pair_val = unsafe { (*entries_ptr).get_prop_at(i) }; if !pair_val.is_object() { continue; } let pair_ptr = pair_val.as_js_object_ptr(); if pair_ptr.is_null() { continue; } let pair = unsafe { &*pair_ptr }; let key_val = pair.get_prop_at(0); let value_val = pair.get_prop_at(1); let key_str = oxide_runtime_api::to_string(key_val); let si = vm.kernel_core().perm_interner().intern(&key_str).0; let promoted = vm.promote_if_needed_for_write_ptr(obj, value_val); let _ = vm.ordinary_set(unsafe { &mut *obj }, si, promoted, target_val); } NativeResult::Ok(target_val) } /// `Object.getPrototypeOf(obj)`:返回对象的 prototype。 pub fn object_get_prototype_of(vm: &mut H, args: &[u8]) -> NativeResult { let obj_ptr = native_try!(require_obj_arg(vm, args, "getPrototypeOf")); NativeResult::Ok(unsafe { (*obj_ptr).proto() }) } /// `Object.hasOwn(obj, key)`:对象是否有指定自身属性。 pub fn object_has_own(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 3 { return NativeResult::Ok(JsValue::bool(false)); } let obj_ptr = native_try!(require_obj_arg(vm, args, "hasOwn")); let key_si = vm.property_key_si(vm.reg(args[2])); let obj = unsafe { &*obj_ptr }; NativeResult::Ok(JsValue::bool(vm.get_own_property_slot(obj, key_si).is_some())) } /// `Object.prototype.valueOf`:返回 this 本身(配合 OrdinaryToPrimitive 的兜底)。 pub fn object_proto_value_of(vm: &mut H, args: &[u8]) -> NativeResult { // Object.prototype.valueOf 原样返回 this 对象;OrdinaryToPrimitive // 因结果非原始值而继续走 toString。 NativeResult::Ok(vm.reg(args[0])) } /// `Object.prototype.toString`:返回 `[object Object]`(暂不区分具体类型标签)。 pub fn object_proto_to_string(vm: &mut H, args: &[u8]) -> NativeResult { let this_val = vm.reg(if args.is_empty() { 0 } else { args[0] }); let tag = if !this_val.is_object() { if this_val.is_string() { "String" } else if this_val.is_int() || this_val.is_double() { "Number" } else if this_val.is_bool() { "Boolean" } else if this_val.is_symbol() { "Symbol" } else { "Object" } } else { let ptr = this_val.as_js_object_ptr(); if ptr.is_null() { "Object" } else { let obj = unsafe { &*ptr }; if obj.is_array() { "Array" } else if obj.is_function() { "Function" } else if obj.is_string_obj() { "String" } else if obj.is_number_obj() { "Number" } else if obj.is_boolean_obj() { "Boolean" } else if obj.is_regexp_obj() { "RegExp" } else if obj.is_date_obj() { "Date" } else if obj.is_typed_array_obj() { "TypedArray" } else if obj.is_array_buffer_obj() { "ArrayBuffer" } else { "Object" } } }; NativeResult::Ok(vm.new_string(&format!("[object {tag}]"))) } /// `Object.prototype.hasOwnProperty(key)`:this 是否有指定自身属性。 pub fn object_proto_has_own_property(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Ok(JsValue::bool(false)); } let this_val = vm.reg(args[0]); if !this_val.is_object() || this_val.as_js_object_ptr().is_null() { return NativeResult::Err(crate::error::create_type_error( vm, "Object.prototype.hasOwnProperty called on non-object", )); } let key_si = vm.property_key_si(vm.reg(args[1])); let obj = unsafe { &*this_val.as_js_object_ptr() }; NativeResult::Ok(JsValue::bool(vm.get_own_property_slot(obj, key_si).is_some())) } /// `Object.prototype.propertyIsEnumerable(key)`:指定自身属性是否可枚举。 pub fn object_proto_property_is_enumerable(vm: &mut H, args: &[u8]) -> NativeResult { if args.len() < 2 { return NativeResult::Ok(JsValue::bool(false)); } let this_val = vm.reg(args[0]); if !this_val.is_object() || this_val.as_js_object_ptr().is_null() { return NativeResult::Err(crate::error::create_type_error( vm, "Object.prototype.propertyIsEnumerable called on non-object", )); } let key_si = vm.property_key_si(vm.reg(args[1])); let obj = unsafe { &*this_val.as_js_object_ptr() }; let Some(pos) = vm.get_own_property_slot(obj, key_si) else { return NativeResult::Ok(JsValue::bool(false)); }; let enumerable = obj .prop_meta_at(pos) .map(|meta| meta.attributes.enumerable()) .unwrap_or(PropAttributes::DEFAULT_DATA.enumerable()); NativeResult::Ok(JsValue::bool(enumerable)) } /// `Object.entries(obj)`:返回可枚举自身属性的 `[key, value]` 对数组。 pub fn object_entries(vm: &mut H, args: &[u8]) -> NativeResult { let obj_ptr = native_try!(require_obj_arg(vm, args, "entries")); let obj = unsafe { &*obj_ptr }; let keys = walk_own_keys(vm, obj); let owned_keys: Vec<(u32, u32)> = keys .into_iter() .filter(|(_si, offset)| { obj.prop_meta_at(*offset) .map(|m| m.attributes.enumerable()) .unwrap_or(PropAttributes::DEFAULT_DATA.enumerable()) }) .collect(); let n = owned_keys.len(); let array_proto = vm.session().builtin_world().array_proto.as_ptr() as *mut JsObject; let arr = vm.alloc_object(JsObject::new_array( EMPTY_SHAPE_ID, JsValue::from_js_object(array_proto), n, vm.epoch().bump(), )); for (i, (si, offset)) in owned_keys.iter().enumerate() { let key_str = vm.kernel_core().perm_interner().lookup(*si).unwrap_or_default(); let key_val = vm.new_string(key_str); let val = obj.get_prop_at(*offset); let pair = vm.alloc_object(JsObject::new_array( EMPTY_SHAPE_ID, JsValue::from_js_object(array_proto), 2, vm.epoch().bump(), )); unsafe { (*pair).set_prop_at(0, key_val); (*pair).set_prop_at(1, val); (*pair).set_prop_count(2); (*arr).set_prop_at(i, JsValue::from_js_object(pair)); } } unsafe { (*arr).set_prop_count(n); } NativeResult::Ok(JsValue::from_js_object(arr)) } /// `Object.values(obj)`:返回可枚举自身属性的值数组。 pub fn object_values(vm: &mut H, args: &[u8]) -> NativeResult { let obj_ptr = native_try!(require_obj_arg(vm, args, "values")); let obj = unsafe { &*obj_ptr }; let keys = walk_own_keys(vm, obj); let owned_keys: Vec<(u32, u32)> = keys .into_iter() .filter(|(_si, offset)| { obj.prop_meta_at(*offset) .map(|m| m.attributes.enumerable()) .unwrap_or(PropAttributes::DEFAULT_DATA.enumerable()) }) .collect(); let n = owned_keys.len(); let array_proto = vm.session().builtin_world().array_proto.as_ptr() as *mut JsObject; let arr = vm.alloc_object(JsObject::new_array( EMPTY_SHAPE_ID, JsValue::from_js_object(array_proto), n, vm.epoch().bump(), )); for (i, (_si, offset)) in owned_keys.iter().enumerate() { let val = obj.get_prop_at(*offset); unsafe { (*arr).set_prop_at(i, val); } } unsafe { (*arr).set_prop_count(n); } NativeResult::Ok(JsValue::from_js_object(arr)) }