Skip to content

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

4.7 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 (
	"slices"

	"github.com/dop251/goja"
)

// expandoProperties 保存脚本在宿主对象上自行添加的属性,使流对象能像浏览器中的平台对象一样挂载自定义属性、
// 被子类用类字段扩展;内建成员都由原型上的访问器与方法提供,不经过这里。与 kernel/plugin/formdata/webidl.go
// 的同名类型同构:本包不依赖 formdata 包,因此复制一份这些通用、不含业务逻辑的 WebIDL 辅助。
type expandoProperties struct {
	keys   []string
	values map[string]goja.Value
}

func (e *expandoProperties) Get(key string) goja.Value { return e.values[key] }

func (e *expandoProperties) Set(key string, value goja.Value) bool {
	if e.values == nil {
		e.values = map[string]goja.Value{}
	}
	if _, ok := e.values[key]; !ok {
		e.keys = append(e.keys, key)
	}
	e.values[key] = value
	return true
}

func (e *expandoProperties) Has(key string) bool {
	_, ok := e.values[key]
	return ok
}

func (e *expandoProperties) Delete(key string) bool {
	if _, ok := e.values[key]; ok {
		delete(e.values, key)
		e.keys = slices.DeleteFunc(e.keys, func(k string) bool { return k == key })
	}
	return true
}

func (e *expandoProperties) Keys() []string { return slices.Clone(e.keys) }

// newMethod 创建 name 与 length 符合规范的原生函数;goja 默认以 Go 函数的完整限定名作为函数的 name。
func newMethod(rt *goja.Runtime, name string, length int, fn func(goja.FunctionCall) goja.Value) *goja.Object {
	method := rt.ToValue(fn).(*goja.Object)
	must(method.DefineDataProperty("name", rt.ToValue(name), goja.FLAG_FALSE, goja.FLAG_TRUE, goja.FLAG_FALSE))
	must(method.DefineDataProperty("length", rt.ToValue(length), goja.FLAG_FALSE, goja.FLAG_TRUE, goja.FLAG_FALSE))
	return method
}

// defineMethod 按 WebIDL 操作的属性特性(可写、可配置、可枚举)在 target 上定义方法。
func defineMethod(rt *goja.Runtime, target *goja.Object, name string, length int, fn func(goja.FunctionCall) goja.Value) {
	method := newMethod(rt, name, length, fn)
	must(target.DefineDataProperty(name, method, goja.FLAG_TRUE, goja.FLAG_TRUE, goja.FLAG_TRUE))
}

// defineGetter 按 WebIDL 只读属性的特性(无 setter、可配置、可枚举)在 target 上定义访问器。
func defineGetter(rt *goja.Runtime, target *goja.Object, name string, get func(goja.FunctionCall) goja.Value) {
	getter := newMethod(rt, "get "+name, 0, get)
	must(target.DefineAccessorProperty(name, getter, nil, goja.FLAG_TRUE, goja.FLAG_TRUE))
}

// defineToStringTag 定义 Symbol.toStringTag,使 Object.prototype.toString 返回 [object <tag>]。
func defineToStringTag(rt *goja.Runtime, target *goja.Object, tag string) {
	must(target.DefineDataPropertySymbol(goja.SymToStringTag, rt.ToValue(tag), goja.FLAG_FALSE, goja.FLAG_TRUE,
		goja.FLAG_FALSE))
}

// newInterfaceConstructor 创建接口的构造函数,并按 WebIDL 设置 name、length、prototype 与 prototype.constructor
// 的属性特性。construct 应以 call.This.Prototype() 作为实例原型,使子类构造的实例继承子类的原型。
func newInterfaceConstructor(rt *goja.Runtime, name string, length int, prototype *goja.Object,
	construct func(goja.ConstructorCall) *goja.Object) *goja.Object {
	constructor := rt.ToValue(construct).(*goja.Object)
	must(constructor.DefineDataProperty("name", rt.ToValue(name), goja.FLAG_FALSE, goja.FLAG_TRUE, goja.FLAG_FALSE))
	must(constructor.DefineDataProperty("length", rt.ToValue(length), goja.FLAG_FALSE, goja.FLAG_TRUE,
		goja.FLAG_FALSE))
	must(constructor.DefineDataProperty("prototype", prototype, goja.FLAG_FALSE, goja.FLAG_FALSE, goja.FLAG_FALSE))
	must(prototype.DefineDataProperty("constructor", constructor, goja.FLAG_TRUE, goja.FLAG_TRUE, goja.FLAG_FALSE))
	return constructor
}

// must 在 err 非 nil 时 panic;仅用于"失败说明调用方传参有编程错误"的内部断言场景(如重复定义同名属性),不用于
// 可能来自脚本输入的失败路径。
func must(err error) {
	if err != nil {
		panic(err)
	}
}

// dictMember 读取字典对象 object 上名为 name 的成员,缺失或为 undefined 时返回 nil;调用方据此套用默认值,
// 不能直接对 Get 的结果调用 ToBoolean/String/ToInteger 等方法——goja 的 Get 在属性不存在时返回 Go 的 nil
// (不是脚本意义上的 undefined 值),对 nil 调用这些方法会触发 nil 指针解引用而不是产生一个"假值"。
func dictMember(object *goja.Object, name string) goja.Value {
	value := object.Get(name)
	if value == nil || goja.IsUndefined(value) {
		return nil
	}
	return value
}