KossJS

Appearance

KossJS 全局对象 ​

KossJS 是一个只读的全局对象，在 KossJS 运行时初始化时自动注入到 JavaScript 环境中，提供运行时的基本信息。

对象结构 ​

javascript
KossJS = {
    version: "0.1.0-dev.8",  // 当前 KossJS 版本号
    runtime: "KossJS",        // 运行时名称（固定值）
    isStable: true,           // 是否为稳定模式
}

属性说明 ​

属性类型说明
versionstring当前 KossJS 版本号，从 src/version.rs 动态获取
runtimestring运行时标识，固定为 "KossJS"
isStablebooleantrue 表示稳定模式（默认），false 表示不稳定模式（启用 FFI / Worker）

使用示例 ​

javascript
// 获取版本信息
console.log(KossJS.version);   // "0.1.0-dev.8"
console.log(KossJS.runtime);   // "KossJS"

// 检测当前模式
if (KossJS.isStable) {
    console.log("稳定模式：FFI 和 Worker 已禁用");
} else {
    console.log("不稳定模式：FFI 和 Worker 可用");
}

安全保护机制 ​

KossJS 对象采用双层保护，防止被恶意篡改：

Rust 层保护 ​

所有属性均设置为 READONLY | ENUMERABLE | PERMANENT：

攻击向量防护措施
KossJS = {}READONLY 阻止重新赋值
KossJS.version = "x"READONLY 阻止属性修改
delete KossJS.versionPERMANENT 阻止删除属性
Object.defineProperty(...)PERMANENT 阻止重新定义属性

JS 层加固 ​

Rust 层注册后，立即执行 JS 加固代码：

  1. 创建一个 Object.create(null) 的无原型对象
  2. 复制所有属性到新对象
  3. Object.freeze() 冻结新对象
  4. 用 Object.defineProperty 替换 globalThis.KossJS，设置为 writable: false, configurable: false

这确保了即使绕过 Rust 层保护，JS 层也无法修改该对象。

稳定模式检测 ​

除了直接读取 KossJS.isStable，也可以通过检测原生函数是否存在来间接判断：

javascript
// 方式 1：直接读取（推荐）
if (KossJS.isStable) { /* 稳定模式 */ }

// 方式 2：间接检测（备选）
const isStable = typeof __koss_create_worker_pool !== 'function';

TIP

推荐使用 KossJS.isStable，语义更清晰，且不依赖内部实现细节。