refactor: 清掉指向不存在的 Dispatch 的文档,删掉为它留的死导出

Dispatch 在仓库里出现 7 次,全是注释和错误文案,没有任何实现。三处错误文案
写着「需要回调语义请用 Dispatch」——使用者按这句去查会找不到东西,真正该指的
是 WithCall。caller.go 那句还指向不存在的子包 jscriptx/dispatch。

连带删掉四个为它留的导出(全仓库零调用):

  Target                   统一 Script/Instance 的接口。有未导出方法 owner(),
                           外部实现不了;也没有任何函数以它为参数或返回值
  ErrUnsupportedSignature  哨兵错误,库自己从不产生它
  KindSignature            错误分类,全仓库唯一一次出现就是它自己的声明。
                           留着会让写 switch 的人为一个永不出现的分支写代码
  OverlayLoader.Loaders    零调用的 getter,连测试都没有

另外删掉 Instance.IdleFor 和 lastUsed 字段:它是给「空闲回收」用的,而
doc.go 明确写着本库不代管实例生命周期、没有空闲回收——字段注释和包文档直接
对立。代价是每次 Call 白付两次 time.Now() + atomic store。业务侧真要自己回收,
记一个时间戳是一行的事。

caller 的示例原来拿 ErrUnsupportedSignature 当哨兵,改成自己声明一个——
回调签名的约定本来就是调用方定的,哨兵该归调用方。

验证:framework-v2 和 lx-bid 都仍能编译。
This commit is contained in:
2026-09-10 15:15:10 +08:00
parent ad722b12f9
commit 9b3509ae29
7 changed files with 28 additions and 59 deletions
+11 -14
View File
@@ -23,8 +23,6 @@ var (
ErrInterrupted = errors.New("jscriptx: 脚本被中断")
// ErrClosed 脚本或引擎已经关闭。
ErrClosed = errors.New("jscriptx: 已关闭")
// ErrUnsupportedSignature 回调函数的形参个数不在 Dispatch 支持的范围内。
ErrUnsupportedSignature = errors.New("jscriptx: 不支持的回调签名")
// ErrValueEscape 脚本试图把只在 VM 内部有效的值(函数/闭包)传到 Go 侧。
ErrValueEscape = errors.New("jscriptx: 该值不能跨出脚本边界")
// ErrBadGlobal 全局白名单配置不合法。
@@ -39,17 +37,16 @@ var (
type Kind string
const (
KindLoad Kind = "load" // 加载脚本源码失败
KindCompile Kind = "compile" // 编译(语法解析)失败
KindBind Kind = "bind" // 注入全局白名单失败
KindNotFound Kind = "not_found" // 脚本或函数不存在
KindRuntime Kind = "runtime" // 脚本运行期抛出异常
KindTimeout Kind = "timeout" // 超时被中断
KindCanceled Kind = "canceled" // 调用方 context 被取消
KindPanic Kind = "panic" // Go 侧 panic,已兜住转成 error
KindType Kind = "type" // 返回值/参数类型不匹配
KindSignature Kind = "signature" // 回调签名不受支持
KindClosed Kind = "closed" // 脚本已关闭
KindLoad Kind = "load" // 加载脚本源码失败
KindCompile Kind = "compile" // 编译(语法解析)失败
KindBind Kind = "bind" // 注入全局白名单失败
KindNotFound Kind = "not_found" // 脚本或函数不存在
KindRuntime Kind = "runtime" // 脚本运行期抛出异常
KindTimeout Kind = "timeout" // 超时被中断
KindCanceled Kind = "canceled" // 调用方 context 被取消
KindPanic Kind = "panic" // Go 侧 panic,已兜住转成 error
KindType Kind = "type" // 返回值/参数类型不匹配
KindClosed Kind = "closed" // 脚本已关闭
)
// Frame 是脚本调用栈的一帧。从 goja 的栈信息里摘出来重新包装,
@@ -156,7 +153,7 @@ func newError(kind Kind, script, fn string, cause error, format string, a ...any
}
// classify 把 goja 抛出来的各种错误翻译成 *Error 并补上脚本上下文。
// 已经是 *Error 的(比如 Dispatch 内部自己造的类型错误)原样返回。
// 已经是 *Error 的(比如 invoke 自己造的类型错误)原样返回。
func classify(err error, script, fn string, args []any) error {
if err == nil {
return nil