Skip to content

An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作

3.0 KB
Raw Blame
// SiYuan - https://github.com/siyuan-note/siyuan
// Copyright (c) 2020-present, b3log.org
// SPDX-License-Identifier: AGPL-3.0-or-later

package streams

import "github.com/dop251/goja"

// deferred 包装 rt.NewPromise() 返回的三元组,供需要重复创建、随时 resolve/reject 的内部 Promise
// (如 reader/writer 的 closed、ready)使用。
type deferred struct {
	promise *goja.Promise
	resolve func(any) error
	reject  func(any) error
}

func newDeferred(rt *goja.Runtime) deferred {
	p, resolve, reject := rt.NewPromise()
	return deferred{promise: p, resolve: resolve, reject: reject}
}

// value 返回可暴露给脚本的 Promise 值。
func (d deferred) value(rt *goja.Runtime) goja.Value { return rt.ToValue(d.promise) }

// isPending 返回该 Promise 当前是否仍处于 pending 状态。
func (d deferred) isPending() bool { return d.promise.State() == goja.PromiseStatePending }

// newResolvedPromise 返回一个已经以 value 兑定的 Promise 值。
func newResolvedPromise(rt *goja.Runtime, value goja.Value) goja.Value {
	p, resolve, _ := rt.NewPromise()
	if err := resolve(value); err != nil {
		panic(err)
	}
	return rt.ToValue(p)
}

// newRejectedPromise 返回一个已经以 reason 拒绝的 Promise 值。
func newRejectedPromise(rt *goja.Runtime, reason goja.Value) goja.Value {
	p, _, reject := rt.NewPromise()
	if err := reject(reason); err != nil {
		panic(err)
	}
	return rt.ToValue(p)
}

// awaitResult 统一处理"可能是 Promise,也可能是普通值"的结果:result 不是 Promise 时直接以其值调用
// onFulfilled;是 Promise 时注册 then 回调。goja 把 Promise 反应(包括已经 settle 的 Promise 上新注册的
// then 回调)排进内部 job 队列,只在最外层脚本调用整体返回、控制权交还给 Go 的那一刻才循环排空(而不是
// 在 then()/resolve() 调用的当下同步触发),因此 onFulfilled/onRejected 的实际调用时机既不是
// awaitResult 返回前,也不保证在当前 Go 调用栈内——只保证最终会被调用(除非对应的 Promise 永不 settle)。
func awaitResult(rt *goja.Runtime, result goja.Value, onFulfilled func(value goja.Value), onRejected func(reason goja.Value)) {
	promise, ok := asPromise(result)
	if !ok {
		onFulfilled(result)
		return
	}

	object := rt.ToValue(promise).ToObject(rt)
	then, ok := goja.AssertFunction(object.Get("then"))
	if !ok {
		// 不应该发生:goja 的 Promise 对象总有可调用的 then。退化为直接按当前导出值处理,不中断调用方。
		onFulfilled(result)
		return
	}

	if _, err := then(object,
		rt.ToValue(func(call goja.FunctionCall) goja.Value {
			onFulfilled(call.Argument(0))
			return goja.Undefined()
		}),
		rt.ToValue(func(call goja.FunctionCall) goja.Value {
			onRejected(call.Argument(0))
			return goja.Undefined()
		}),
	); err != nil {
		panic(err)
	}
}

// asPromise 判断 value 是否导出为 *goja.Promise。
func asPromise(value goja.Value) (*goja.Promise, bool) {
	if value == nil {
		return nil, false
	}
	p, ok := value.Export().(*goja.Promise)
	return p, ok
}