
SafeScript 2.0 发布:JavaScript 安全子集新增浏览器内调试支持
来源标题:SafeScript 2.0: safe subset of JavaScript, now supports debugging in the browser
SafeScript 2.0 发布,在原有编译器、沙箱和 DOM 封装之上新增事务性运行时,所有变更先写入日志、提交后才生效。新版本还引入调试协议,允许 IDE、Web Worker 或远程工具从外部控制代码执行,并支持在浏览器内调试。此外,new 操作符现可配合构造函数白名单使用。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Code Issues1 (1) Pull requests Actions Projects Security and quality Insights More items Releases v2.0.0 v2.0.0 Latest Latest Compare Choose a tag to compare Sorry, something went wrong. Filter Loading Sorry, something went wrong. Uh oh! There was an error while loading. Please reload this page. v2.0.0 b795e4c SafeScript 2.0 发布说明 SafeScript 2.0 将一门安全语言变成了一个开发环境。v1.x 中的编译器、沙箱和 DOM 门面保持不变。新增的是叠加在其上的事务性运行时:每一次变更都经过日志(journal),在你提交之前不会有任何改动,并且有一套调试协议让任意驱动方(IDE、Web Worker、远程工具)从外部控制执行。 现在允许使用 new,但需通过构造函数白名单。内置的安全类型(Map、Set、Date、RegExp、Error 家族)始终可用。宿主注册的类型和每次运行时的 opts.allowNew 构造函数也可用。未注册的构造函数会在运行时抛出异常。 var m = new Map(); m.set('key', 'value'); var d = new Date(2024, 0, 1); var pattern = new RegExp('^test', 'i'); // 宿主允许 await SafeScript.run('return new Point(1, 2);', { Point }, { allowNew: [Point] }); 返回值净化(v1.4+) run() 现在会将返回值净化为 POD(纯旧数据)。返回对象中的函数会被剥离。原始值、普通对象/数组以及安全内置类型的实例会原样通过。使用 opts.rawReturn: true 可禁用此行为。 SafeScript.debug(source, scope, opts) 会以检查点插桩方式编译(每条语句后插入 __dbg),并返回一个 DebugSession。会话在第一条语句处暂停并等待命令。无需浏览器 DevTools——调试 UI 可以是任何东西。 var session = SafeScript.debug(source, scope, { onPause: function(info) { renderUI(info.line, info.locals); }, onFinish: function(value) { showResult(value); } }); session.step(); // 前进一条语句 session.continue(); // 运行到下一个断点或结束 session.toggleBreakpoint(10); // 在第 10 行设置/清除断点 session.stop(); // 中止 日志——事务性执行(v2.0) 调试模式下的所有副作用都经过日志(带读覆盖层的预写日志)。对作用域对象的属性写入会被记录,而不会修改真实对象。读取时先检查覆盖层。commit() 应用所有写入。discard() 将它们丢弃。 这意味着你可以运行会修改数据和 DOM 的代码,检查将会发生什么变化,并决定是否保留这些更改——在你准备好之前不会触及真实状态。 每个调试步骤都会连同行号、局部变量快照和副作用记录到历史中。rewindTo(stepIndex) 会将日志游标回滚并从该点恢复局部变量。使用 captureAllLocals: true 可在每一步获取完整快照。 暂停期间,session.editAndContinue(newSource) 会在调试模式下重新编译整个源码,并创建一个替换函数,通过解构接收当前局部变量。编辑后的代码中的新变量可以自然工作。用 session.continue() 恢复以运行新逻辑。 引擎(DebugSession)与驱动方(IDE/UI)之间的双向消息传递接口。与传输方式无关——可通过 postMessage、MessagePort、WebSocket 或进程内函数调用工作。 23 条命令(驱动方 → 引擎),17 个事件(引擎 → 驱动方)。三种内置传输方式:InProcessDriver(同线程)、PostMessageDriver(Web Worker/iframe)、PortDriver(MessagePort/SharedWorker)。 在调试模式下使用 SafeScript 的 DOM 膜时,DOM 变更会自动经由日志路由。属性写入、文本内容、样式更改和 innerHTML 都会经过覆盖层。读取时先检查覆盖层。提交时,更改会应用到真实 DOM。丢弃时,DOM 保持不变。 snapshotDOM() 捕获容器的 innerHTML。restoreDOM(index) 将其恢复。commit() 在应用前会自动快照,因此你始终拥有提交前状态以进行结构性撤销。 反向查找是双向的:给定任意 DOM 元素,getNodeTimeline(element) 返回对它的每一次更改——哪个属性变了、从什么变成什么、以及是哪个调试步骤导致的。queryNodeSteps(element) 返回步骤索引,这些索引可作为 rewindTo() 的目标。 session.evaluate(expression) 在当前暂停的作用域中求值任意 SafeScript 表达式。通过 SafeScript 编译以获得相同的安全保障。只读——不会修改会话状态。 session.setConditionalBreakpoint(line, condition) 仅在条件表达式求值为真时才中断。每次命中断点行时,条件都会通过 session.evaluate() 求值。 session.stepOver() 前进一条语句而不进入函数体。session.stepOut() 运行直到返回调用者层级。两者都使用通过 pushCall() / popCall() 进行的调用深度跟踪。 session.fork() 创建调试会话的独立副本——相同的断点、历史、局部变量、日志——用于并行探索不同的代码路径。 session.serialize() 将会话状态导出为 JSON 安全对象(日志中的对象引用会被替换为数字 ID)。DebugSession.deserialize(data, objectResolver) 将其恢复。专为 Qbix Streams 中的持久化而设计。 session.setLogpoint(line, template) 在到达某行时触发消息而不暂停。模板支持针对当前局部变量的 {expr} 插值(通过 SafeScript 求值,而非原始 eval)。通过协议:setLogpoint / removeLogpoint 命令、logpoint 事件。在 fork 和 serialize 后保留。 编译器在每条语句之前和之后都插入 __dbg 检查点。pauseOn: 'before'(默认)提供标准调试器行为——断点在该行执行前触发。pauseOn: 'after' 在该行运行后暂停。pauseOn: 'both' 在两个阶段都暂停。setPauseOn(mode) 在运行时切换。通过协议:setPauseOn 命令。paused 和 stepped 事件包含一个 phase 字段。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。