Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

对象模型:Shape、存储与属性

对象布局

Object  + OBJECT_SHAPE     *const Shape(null:空对象,或字典模式)
        + OBJECT_INLINE    ValueCell × INLINE_PROPS(前几个属性直接放在对象里)
        + OBJECT_STORE     存储树的 GC 槽:叶子 { 容量, ValueCell × 容量 }

对象把热路径要碰的东西放在可变数据(GcCell)外面:原型、属性(shape 加值存储)、数组元素、函数与正则的不可变数据。 JIT 按 j8framework::Layout 给的偏移直接读写这些字段。

j8 自己的堆结构体用 #[j8framework::heap] 声明,#[mutable] 字段按类型自动选单元(Value ⇒ ValueCell、 Gc ⇒ paragc Slot、布尔与整数 ⇒ 原子量),并生成 getter / setter:

#[j8framework::heap]
pub struct Object<'gc> {
    #[mutable(set = write_proto)]
    proto: Option<JsObject<'gc>>,      // proto() / write_proto(mc, p)
    #[mutable]
    non_extensible: bool,              // non_extensible() / set_non_extensible(mc, b)
    data: GcCell<'gc, ObjectState<'gc>>,
}

Shape(隐藏类)

shape.rs:shape 是对象自有字符串键属性的布局——键与特性,按插入顺序;值另外放在对象的槽里。

  • 以同样方式建出的对象共享 shape:加属性沿转移表走到(或新建)子 shape;
  • 执行层按「shape ⇒ 槽下标」做内联缓存;
  • shape 里没有 Gc 指针(回收会搬对象),用 Arc 管理;转移表存 Weak,没有对象用的 shape 自然释放;
  • 删属性、改特性或键太多时,对象的属性转成字典(Dict,原地修改),内联缓存不接收字典。

值存储

store.rs:属性值与数组元素放在 GC 堆里固定容量的叶子中,大了就是 128 叉树(30 万个元素三层)。 paragc 只分配定长对象,所以按容量分档:

  • 叶子 Leaf<N>:N 个 ValueCell(N = 2 / 4 / … / 128),头一个字是容量;
  • 内部节点 Node:128 个子槽,头一个字是 NODE 加层数。

全部 #[repr(C)]:不管 N 多大,格子都从头字之后开始,抹掉类型后也能按下标找到。读不借用、不加锁; 写经 ValueCell::set 走写屏障。

内部方法

property.rs 实现规范第 10.1 节(普通对象)与 10.4 节(数组、字符串包装对象)的内部方法:

  • [[GetOwnProperty]] / [[DefineOwnProperty]](ValidateAndApplyPropertyDescriptor、ArraySetLength);
  • [[OwnPropertyKeys]]、可扩展性、原型;
  • 数组有稠密部分,加上按下标存的普通属性(空洞、特性各异的元素);length 只读、不可扩展都按规范。

属性访问(ops.rs)经这些内部方法沿原型链走。Proxy 在 proxy.rs 里把同样的入口分派到 trap,并检查不变式。

字符串

text.rs:属性键与 JS 字符串值共用的表示。

  • 不超过 22 字节的短串内联存放,不单独分配;
  • 长串共享一份堆拷贝,从长串切出的片段(split、slice、正则匹配)指向那份拷贝而不复制(V8 的 sliced string);
  • 字符串 + 产生足够长的结果时先存成 rope(两半加总长),第一次需要内容时才拍平并缓存——s += c 的循环 不再每次复制整串;拍平与释放都是迭代的,几十万层的 rope 也不会爆栈;
  • 不含 Gc,GC 不需要管它。

当前字符串按 UTF-8 存储,所以落单的代理项(lone surrogate)会丢失;比较按 UTF-16 码元进行。

宿主对象

ObjectKind::Host:持有 Rust 值的 JS 对象(HostData,Box<dyn Any + Send + Sync>,外面是借用标志)。 绑定方法里以 &self / &mut self 取出;重入的 &mut self 调用抛 TypeError 而不是 panic(见绑定宏)。