docs: 修正数组助手与类型化数组的注释示例

改动点:
- array/common.rs 的 get_this_arraylike:消费者示例由实际不经过本助手的
  values/entries/keys/iterator 改为真实调用族,即遍历查找族、切片拼接族与
  不可变复制族。
- typed_array.rs 的 get_typed_array_data:对象指针为空分支从"接收者不兼容"
  移入"内部状态无效",与代码实际抛出的错误消息一致。

条件项:本批无新增可选 doc 补充,其余 16 处注释与上一提交保持一致。
This commit is contained in:
2026-09-17 12:41:02 +00:00
parent c9eef0f417
commit aaad3786b7
2 changed files with 5 additions and 3 deletions
+3 -1
View File
@@ -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。
+2 -2
View File
@@ -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 仍由对象持有,