- 简体中文 [zh-Hans] # 当前
- 繁體中文 (香港) [zh-Hant-HK]
- 繁體中文 (台灣) [zh-Hant-TW]
- English [en]
- Français [fr]
- Español [es]
- 日本語 [ja]
- 한국어 [ko]
- Русский [ru]
- العربية [ar]
Rhino for AutoJs6 是面向 AutoJs6 的 Rhino JavaScript 引擎分支. 本仓库在 Mozilla Rhino 的基础上维护 Android 兼容性与宿主集成适配, 为 AutoJs6 提供引擎源码和完整 JAR 的构建入口.
阅读原始 Rhino 官方 README. 该入口固定到提交 d878324a6f515c09d8ca49005fdd22b944b4df89, 保留上游原有语言与相对链接的上下文. 这份原始文档仅作留存, 不参与翻译; 本页及其其他语言版本介绍本分支.
另提供逐字节保存的 README 原始文本 与 来源及校验记录. 持续维护的资料可参阅 Rhino 官方仓库 和 官方文档站. 上游 RELEASE-NOTES.md 保留原文.
- Android 反射, 线程上下文与旧版系统兼容性, 以及 AutoJs6 使用的作用域和 Java 互操作接口.
- XML/E4X 与 AutoJs6 UI 模式的适配, 保留宿主所需的 XML 解析行为.
- 引擎错误消息的多语言资源, 与本仓库 README/CHANGELOG 的多语言文档分别维护.
- 保留桌面 JVM 工具与服务资源的完整
rhino-allJAR, 供宿主进一步派生 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 checkAutoJs6 从 libs/org-mozilla-rhino-2_0_0-SNAPSHOT.jar 引用完整 JAR. 宿主的 slimRhinoJar 任务生成 Android 运行时包, 移除 JLine, JVM 优化编译器与 JFR 组件, 保留解释器, XML 和调试能力. 更新引擎时还需验证宿主的编译, D8/APK 打包与相关脚本行为; 单独构建 Rhino 成功不能替代这些验证.
AutoJs6 仓库 / AutoJs6 脚本文档 / 本分支问题反馈. Rhino 通用 API 与上游贡献说明可从原始官方文档入口查阅.
此处按日期记录本分支的维护变更. Rhino 官方发行历史继续保留在上游发行说明中, 不作为本分支的新版本记录.
修复多线程下的 Promise: 其他线程落定NativePromise时同时添加的反应不再丢失, 嵌入方可覆盖Context.forwardTask, 把落定交给有事件循环的线程, 并让await回到 async 函数所在的线程恢复修复Promise 里的错误保持原样: 执行器或反应因引擎错误失败时, 拒绝原因与catch捕获到的错误对象相同, 保留消息, 位置与调用栈. 未处理的拒绝按发生顺序报告修复捕获续体失败时不再影响正在运行的函数: 原先捕获到这个错误之后, 生成器或 async 函数恢复时会回到错误的位置
新增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() {}) 也提前初始化
新增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的settrap 返回 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/testsRhino 使用 MPL 2.0 许可证. 原始文档与源码保留上游版权及许可声明.