jscriptx

2 Commits 1 Branch 0 Tags

2 Commits

Author	SHA1	Message	Date
what	7fb8d0f966	test: 测试用的最小扩展本库不带内置扩展——扩展该由用引擎的人按自己的场景定义，引擎只给接口。但测「作用域共享状态」「扩展改名」「VM 复用后状态还在不在」这些行为，手上得有一个真的扩展，所以放一个最小的在 internal 下。 Incr 用 float64 而不是整数：JS 的数字就是 float64，脚本写进来的值也是这个类型，用整数会让「Go 侧读回来」的断言在类型上对不上。	2026-09-05 22:12:14 +08:00
what	0627d49425	feat: 嵌入式 JS 脚本引擎核心用 goja 承载业务回调，让业务逻辑变更不必重新编译发布 Go 程序。脚本用 ESM + TypeScript 写，Go 侧按名字把它们当普通对象实例化并调用方法。主要组成： - Engine 编译脚本、管配置，公开 API 不暴露任何 goja 类型 - Script 一份编译好的脚本 + 它的 VM 池，热更新时整体顶替 - Instance 独占一个 VM 的实例，状态留在 JS 侧 - Caller 自定义调用约定，把脚本函数适配成 Go 侧要的签名 - Scope 让同一个 ctx 下的多个脚本共享 Go 侧对象 - Extension 扩展接口：给脚本添全局对象，配套 TS 类型 - Overlay 多层 Loader 叠加，后面的盖前面的几个关键取舍： - 源码一律先过 esbuild 打包成 ESM，再改写成立即执行函数。goja 不认 import/export，而业务脚本要能拆文件、用 TypeScript。 - VM 池化复用，但每个 VM 单线程。goja 的 Runtime 不是 goroutine 安全的。 - Go 侧函数返回的 error 在脚本里表现为抛异常，不占返回值位置。 - 脚本能看见的全局只有白名单放行的那些，且注入是惰性的——没读到的全局根本不会被转换。	2026-09-05 22:11:55 +08:00

Author

SHA1

Message

Date

what

7fb8d0f966

test: 测试用的最小扩展

本库不带内置扩展——扩展该由用引擎的人按自己的场景定义，引擎只给接口。
但测「作用域共享状态」「扩展改名」「VM 复用后状态还在不在」这些行为，
手上得有一个真的扩展，所以放一个最小的在 internal 下。

Incr 用 float64 而不是整数：JS 的数字就是 float64，脚本写进来的值也是
这个类型，用整数会让「Go 侧读回来」的断言在类型上对不上。

2026-09-05 22:12:14 +08:00

what

0627d49425

feat: 嵌入式 JS 脚本引擎核心

用 goja 承载业务回调，让业务逻辑变更不必重新编译发布 Go 程序。脚本用
ESM + TypeScript 写，Go 侧按名字把它们当普通对象实例化并调用方法。

主要组成：

  - Engine    编译脚本、管配置，公开 API 不暴露任何 goja 类型
  - Script    一份编译好的脚本 + 它的 VM 池，热更新时整体顶替
  - Instance  独占一个 VM 的实例，状态留在 JS 侧
  - Caller    自定义调用约定，把脚本函数适配成 Go 侧要的签名
  - Scope     让同一个 ctx 下的多个脚本共享 Go 侧对象
  - Extension 扩展接口：给脚本添全局对象，配套 TS 类型
  - Overlay   多层 Loader 叠加，后面的盖前面的

几个关键取舍：

  - 源码一律先过 esbuild 打包成 ESM，再改写成立即执行函数。goja 不认
    import/export，而业务脚本要能拆文件、用 TypeScript。
  - VM 池化复用，但每个 VM 单线程。goja 的 Runtime 不是 goroutine 安全的。
  - Go 侧函数返回的 error 在脚本里表现为抛异常，不占返回值位置。
  - 脚本能看见的全局只有白名单放行的那些，且注入是惰性的——没读到的
    全局根本不会被转换。

2026-09-05 22:11:55 +08:00