YStudio Y++

JS类

Y++ / YStudio 开发文档 · 一点滴

类对象支持库(不是扁平命令)。路径:支持库 → 扩展类库 → JS类。

类型名必须写完整「JS类」。声明时自动创建,一般无需再调 创建*。

硬约束

  1. 类型名必须写「JS类」。内嵌 JS 引擎(无 DOM)。
  2. 方法调用必须带括号。
  3. 脚本错误看返回值 / 错误信息(以签名为准)。

快速开始

JS类 js
// 执行脚本 / 调用函数:见签名表

JS类/创建

共 1 条。

创建JS

  • 签名:通用 创建JS()
  • 说明:显式创建一个 JS 引擎(一般直接写「JS类 eng」即可,声明时自动创建)。

JS类/方法

共 7 条。

执行

  • 签名:逻辑 执行(文本 脚本)
  • 说明:在当前引擎中 eval 脚本;成功返回真,失败返回假(看 取错误())。
  • 参数一│文本 脚本: JavaScript 源码(可用普通字符串或 R”js(… )js” 原始字符串)。

加载

  • 签名:逻辑 加载(文本 文件路径)
  • 说明:按 UTF-8 读取本地.js 文件并执行;成功返回真。
  • 参数一│文本 文件路径: 如 “d:\sign.js” 或相对工程路径。

置全局

  • 签名:逻辑 置全局(文本 名称, 文本 值)
  • 说明:向本引擎全局对象写入字符串属性(≈ JS: globalThis.名称 = 值)。 适合把大段入参塞进脚本,再 执行/加载 整段逻辑。
  • 参数一│文本 名称: 全局变量名(如 “body”)。
  • 参数二│文本 值: 字符串内容(目前仅文本类型)。

取全局

  • 签名:文本 取全局(文本 名称)
  • 说明:读取本引擎全局属性并转为文本(≈ 读 globalThis.名称);不存在则空文本。
  • 参数一│文本 名称: 全局变量名。

调用

  • 签名:文本 调用(文本 函数名, [文本 参数JSON])
  • 说明:调用全局函数,返回值转为文本。第二参必须是 JSON 数组文本。 适合:加载站点加密脚本后调用 getSign / encrypt 等。
  • 参数一│文本 函数名: 全局函数名(如 “add”、”getSign”)。
  • 参数二│[文本 参数JSON]: 默认 “[]”,须为合法 JSON 数组,如 “[1,2]”。
  • 参数JSON 里的引号:普通字符串要写成 ";长参数强烈建议用 @”[…]”。

取错误

  • 签名:文本 取错误()
  • 说明:返回最近一次 执行/加载/置全局/调用 失败的错误信息;无错时为空文本。

重置

  • 签名:无 重置()
  • 说明:销毁并重建本引擎(清除已加载脚本与全局变量)。

易错对照

错误 正确
类型写成 JS 必须「JS类」
当浏览器 DOM 无 DOM,仅脚本引擎

相关

JSON类 · HTTP类