Skip to content

About

Rhino is an open-source implementation of JavaScript written entirely in Java

Resources

Code of conduct

Security policy

Stars

7 stars

Watchers

1 watching

Forks

 
 

Latest commit

 

History

5,527 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rhino for AutoJs6

语言

Rhino for AutoJs6 是面向 AutoJs6 的 Rhino JavaScript 引擎分支. 本仓库在 Mozilla Rhino 的基础上维护 Android 兼容性与宿主集成适配, 为 AutoJs6 提供引擎源码和完整 JAR 的构建入口.

原始 Rhino 官方文档

阅读原始 Rhino 官方 README. 该入口固定到提交 d878324a6f515c09d8ca49005fdd22b944b4df89, 保留上游原有语言与相对链接的上下文. 这份原始文档仅作留存, 不参与翻译; 本页及其其他语言版本介绍本分支.

另提供逐字节保存的 README 原始文本 与 来源及校验记录. 持续维护的资料可参阅 Rhino 官方仓库 和 官方文档站. 上游 RELEASE-NOTES.md 保留原文.

分支维护范围

  • Android 反射, 线程上下文与旧版系统兼容性, 以及 AutoJs6 使用的作用域和 Java 互操作接口.
  • XML/E4X 与 AutoJs6 UI 模式的适配, 保留宿主所需的 XML 解析行为.
  • 引擎错误消息的多语言资源, 与本仓库 README/CHANGELOG 的多语言文档分别维护.
  • 保留桌面 JVM 工具与服务资源的完整 rhino-all JAR, 供宿主进一步派生 Android 运行时包.

构建与验证

使用本仓库的 Gradle Wrapper 和 JDK 21 或更高版本. Java 源码按 Java 17 编译目标构建. 在仓库根目录运行以下命令, Windows 使用第二条命令:

./gradlew :rhino-all:shadowJar --console=plain --max-workers=4
.\gradlew.bat :rhino-all:shadowJar --console=plain --max-workers=4

完整产物位于 rhino-all/build/libs/rhino-all-<version>.jar, 版本取自 gradle.properties. 该产物包含核心引擎, 工具, XML/E4X 与 JLine. 宿主集成应使用此完整包.

以下命令初始化测试子模块, 运行主要模块与集成测试, 再执行完整检查. Windows 将 ./gradlew 替换为 .\gradlew.bat.

git submodule update --init
./gradlew :rhino:test :rhino-xml:test :rhino-tools:test :rhino-engine:test :tests:test
./gradlew check

与 AutoJs6 集成

AutoJs6 从 libs/org-mozilla-rhino-2_0_0-SNAPSHOT.jar 引用完整 JAR. 宿主的 slimRhinoJar 任务生成 Android 运行时包, 移除 JLine, JVM 优化编译器与 JFR 组件, 保留解释器, XML 和调试能力. 更新引擎时还需验证宿主的编译, D8/APK 打包与相关脚本行为; 单独构建 Rhino 成功不能替代这些验证.

相关项目与反馈

AutoJs6 仓库 / AutoJs6 脚本文档 / 本分支问题反馈. Rhino 通用 API 与上游贡献说明可从原始官方文档入口查阅.

分支维护记录

此处按日期记录本分支的维护变更. Rhino 官方发行历史继续保留在上游发行说明中, 不作为本分支的新版本记录.

2026-11-03

2026/11/03
  • 修复 多线程下的 Promise: 其他线程落定 NativePromise 时同时添加的反应不再丢失, 嵌入方可覆盖 Context.forwardTask, 把落定交给有事件循环的线程, 并让 await 回到 async 函数所在的线程恢复
  • 修复 Promise 里的错误保持原样: 执行器或反应因引擎错误失败时, 拒绝原因与 catch 捕获到的错误对象相同, 保留消息, 位置与调用栈. 未处理的拒绝按发生顺序报告
  • 修复 捕获续体失败时不再影响正在运行的函数: 原先捕获到这个错误之后, 生成器或 async 函数恢复时会回到错误的位置

2026-11-02

2026/11/02
  • 新增 async / await: async 函数, 方法与箭头函数, 返回原生 Promise, await 之后的代码在微任务里继续; 解释与编译模式均可用
  • 新增 for await 与 async 生成器 (async function*), Symbol.asyncIterator, yield* 可委托异步与同步迭代器, class 与对象字面量里都能写 async 方法
  • 优化 嵌入方接口: AsyncTracker 可查询挂起的 async 函数数量与首个挂起位置, UnhandledRejectionTracker 改为每个 Context 一份, 多个脚本线程不再互相串扰
  • 修复 编译模式下生成器里嵌套的 try: 内层重新抛出或内层 finally 里有 yield 时, 外层 catch 接不到异常
  • 修复 严格模式函数体在生成器里恢复执行时沿用了调用方的严格性, 现在总是按函数自身的严格性执行
  • 修复 Promise.all / Promise.race / Promise.any 在取迭代器之前先读取 resolve, 取值抛错时返回被拒绝的 Promise; then 访问器抛错时拒绝而不是向外抛出
  • 修复 new Function 生成的源码符合规范: 参数以 // 注释结尾时不再报错, 生成器写作 function*; Function.prototype.toString 可用于可调用的 Proxy
  • 修复 可选链整条短路: a?.b.c 在 a 为 null / undefined 时整条得 undefined, 后面的下标与实参不再求值; 只有 ?. 才做判断, a?.b.c 在 a.b 为 undefined 时按规范抛 TypeError, a?.b() 在方法不存在时同样抛 TypeError; eval?.() 是间接调用, delete a?.b.c 短路时得 true, 带标签模板与 new a?.b() 是语法错误
  • 修复 块内的 async 函数与生成器声明改为块级作用域, 块外读不到, 也不再覆盖外层同名变量; 普通函数的行为不变
  • 修复 编译模式下生成器与 async 函数里嵌套的 yield / await 按书写的位置求值: yield [g(1), yield 'x'] 先调用 g(1), await (u ? await g() : 2) 在 u 为假时不再调用 g(); [a, b] = [1, yield 2] 不再报 $0 未定义
  • 修复 switch 各 case 里的函数声明在进入 switch 时就初始化, 没走到的 case 里声明的函数也能调用; 非严格模式下外层的同名变量要走到声明时才赋值
  • 修复 调试模式下, 含 for-of, 解构, class ... extends, for await 的脚本不再因为读取行号失败而无法编译
  • 修复 块内的函数声明与 switch 里的一样: 进入块时就初始化, 非严格模式下外层的同名变量要走到声明时才赋值, 解构的 catch 参数绑定了同一个名字时不赋值. 带标签的函数声明 (l: function f() {}) 也提前初始化

2026-10-31

2026/10/31
  • 新增 class 语法: 类声明与表达式, extends / super, 实例与静态字段, 静态块, 私有名 (#x), 类定义的源码由 toString 返回; 解释与编译模式均支持, async 方法留待后续版本
  • 新增 内建构造器可被 class 继承: Error, Array, Map, Set, Date, RegExp, TypedArray 等按 new.target 创建实例, 内建方法返回子类实例
  • 新增 class 可继承 Java 类与接口 (本分支独有): class X extends java.lang.Thread, 多个接口写 class X extends JavaAdapter(Base, I1, I2); 实例包装 Java 对象, 原型指向 X.prototype, 并带有宿主 WrapFactory 为该对象添加的成员
  • 新增 调用与 new 中的实参展开: f(...args), o.m(...args), super.m(...args), new F(...args) (此前编译时报内部错误, 整个脚本无法运行)
  • 修复 逻辑赋值 &&= / ||= / ??= 不短路的问题 (总是写回, 会调用 setter, 在只读属性上报错)
  • 修复 数组解构, 数组展开与 for...of 偏离迭代协议的问题: 变量解构不走迭代器 (Set 与生成器解构得到 undefined), 展开时空洞不查原型链, 提前退出时未关闭或多余关闭迭代器; 不可迭代的类数组对象解构时改为报 TypeError
  • 修复 Proxy 与 Reflect 偏离 ES2024 内部方法的问题: 各 trap 的转发与不变式检查, 原型链上的 Proxy, Reflect 的数组下标键, __proto__ 对 Proxy 经 trap
  • 修复 with 语句不读取 Symbol.unscopables 与重复解析绑定的问题, 以及严格模式下给已删除的全局绑定赋值未报 ReferenceError 的问题
  • 修复 TypedArray 对数字规范字符串键 (含 NaN, -0) 的读写, in, delete, Object.defineProperty 与键顺序偏离规范的问题
  • 修复 Set 的集合方法 (union 等) 读取类集合参数的顺序与检查偏离规范, 以及 Object.fromEntries 读条目时不查原型链的问题
  • 修复 解构默认值在目标已有值时不生效的问题, 以及 valueOf / toString 返回 null 的对象转原始值时结果错误的问题
  • 修复 生成器中未加括号的 yield 在逗号表达式, 条件分支, 对象展开与计算属性名中解析失败的问题
  • 修复 编译模式下内联 __proto__ 的对象字面量里 super 读到 undefined, 以及数字变量作被调用者时抛 VerifyError (应为 TypeError) 的问题
  • 优化 BigInt.asIntN / BigInt.asUintN, DataView 的 setBigInt64 / setBigUint64 与 BigInt 类型的 TypedArray 传入 Number 时按规范报 TypeError (此前转换后继续), 需写 BigInt(x)
  • 优化 严格模式 (含 class 体) 下 Proxy 的 set trap 返回 false 时赋值报 TypeError, 写入 set: undefined 的访问器同样报 TypeError
  • 优化 数组展开 [...a] 与实参展开对密集普通数组使用快速路径, 迭代器未被改写时直接复制

完整分支维护记录

多语言文档维护

修改 .readme/ 与 .changelog/ 中的语言 JSON 和模板, 然后重新生成文档. 简体中文为内容基准, 根目录 README 使用简体中文. 需要 Python 3.10 或更高版本, 无额外 Python 依赖; Windows 可用 py 替代 python. 生成与 --check 均离线运行, 检查模式不写文件. CI 在 Windows 与 Ubuntu 上检查译文结构, 引用, 原文快照完整性及生成产物.

python .python/generate_markdown.py
python .python/generate_markdown.py --check
python -m unittest discover -s .python/tests

许可证

Rhino 使用 MPL 2.0 许可证. 原始文档与源码保留上游版权及许可声明.

About

Rhino is an open-source implementation of JavaScript written entirely in Java

Resources

Code of conduct

Security policy

Stars

7 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages