diff --git a/crates/oxide_builtins/src/array/common.rs b/crates/oxide_builtins/src/array/common.rs
index 76d16377..050bbff7 100644
--- a/crates/oxide_builtins/src/array/common.rs
+++ b/crates/oxide_builtins/src/array/common.rs
@@ -73,7 +73,9 @@ pub(crate) fn get_this_array_ref<H: VmHost>(vm: &mut H, val: JsValue) -> Result<
 }
 
 /// 取 this 为真数组或类数组对象（带 length 属性的普通对象），按规范读取长度，
-/// 返回 (对象指针, 长度, 是否为真数组)，供只读方法族（values/entries/keys/iterator 等）共用。
+/// 返回 (对象指针, 长度, 是否为真数组)，供遍历查找族（forEach/map/filter/reduce/
+/// some/every/find 族/flatMap）、切片拼接族（slice/concat/join/indexOf/includes/
+/// lastIndexOf）与不可变复制族（toReversed/with/toSorted/toSpliced）共用。
 ///
 /// # 步骤
 /// 1. this 非对象（null/undefined/原始值）→ TypeError。
diff --git a/crates/oxide_builtins/src/typed_array.rs b/crates/oxide_builtins/src/typed_array.rs
index d0e1ec90..3c55e90f 100644
--- a/crates/oxide_builtins/src/typed_array.rs
+++ b/crates/oxide_builtins/src/typed_array.rs
@@ -186,8 +186,8 @@ pub fn drop_typed_array_native(obj: &mut JsObject) -> u64 {
 /// 取接收者的 TypedArrayData 视图（按值返回，非借出）。
 ///
 /// # 边界与前提
-/// - 接收者非对象、对象指针为空或不是 TypedArray 对象时抛 TypeError（接收者不兼容）；
-/// - `native_fn` 槽为空值或存空指针时抛 TypeError（内部状态无效）。
+/// - 接收者非对象或不是 TypedArray 对象时抛 TypeError（接收者不兼容）；
+/// - 对象指针为空、`native_fn` 槽为空值或存空指针时抛 TypeError（内部状态无效）。
 ///
 /// # 注意事项
 /// - 返回的是解引用后的拷贝（`Ok(*data_ptr)`），底层 buffer 仍由对象持有，