编译器编程语言语言运行时标准库【免费下载链接】assemblyscriptA TypeScript-like language for WebAssembly.项目地址https://gitcode.com/gh_mirrors/as/assemblyscript点击查看免费下载导读本文以 tests/README.md 为骨架系统讲解 AssemblyScript 仓库中 parser 与 compiler 两套测试体系的组织方式、Fixture 生成机制、测试命令与自定义扩展点。读完本文你将掌握如何新建/更新一条测试用例、如何用--create重建 Fixture、如何通过ASC_FEATURES开启实验特性测试以及如何借助 c8 生成代码覆盖率报告——这些能力直接服务于为 AssemblyScript 编译器贡献代码时的验证流程。测试体系概览一个测试用例由什么组成按照 tests/README.md 的定义tests/目录承载的是AssemblyScript parser 与 compiler 的测试用例。每条测试用例由两部分组成测试源文件.ts被解析parser或编译compiler的 AssemblyScript 源码自动生成的 Fixture固化产物由测试源文件经由工具链自动生成的一至多个对比基准文件。这种源码 派生 Fixture的二元结构意味着测试人员只需要维护.ts源文件Fixture 由命令自动生成但生成后必须人工确认其内容正是你所期望的Make sure the fixture(s) contain exactly what youd expect。任何对源码的改动都必须同步重新生成 Fixture否则 diff 对比会失败。两条贯穿始终的纪律在任何新建/更新测试前都必须遵守先执行npm run clean确保测试运行的是源码src/而不是构建产物dist/。从 package.json 的 scripts 可以看出仓库用node --enable-source-maps直接运行tests/parser与tests/compiler目录入口因此干净的源码状态是测试可信的前提修改.ts后必须按下方指引重新生成 Fixture并人工核对 diff 结果。Parser 测试解析-再序列化-对比目录与原理Parser 测试位于 tests/parser 目录。其工作原理是读取测试源文件.ts用 parser 解析该文件同时记录所有警告warnings与错误errors将 AST重新序列化为一套新的源码文本把警告与错误以//注释的形式追加在新源码末尾将新源码 诊断注释与 FixturetestName.ts.fixture.ts逐字节比对。从 tests/parser.js 的源码可以印证这一流程该文件本身就是测试 runner通过globSync(**/!(_*).ts)收集所有不以_开头的.ts文件第 45 行跳过_开头与以.fixture.ts结尾的文件第 64 行避免把 Fixture 当作测试源用new Program(options)与parser.parseFile(sourceText, filename, true)完成解析第 77-79 行用ASTBuilder.build(program.sources[0])重新序列化源码并把parser.diagnostics逐条以//注释拼接到其后第 80-81 行--create模式下直接写回 Fixture第 84-86 行普通模式则读取既有 Fixture 用diff对比并输出结果第 87-96 行。需要注意的细节部分 parser 测试依赖实验特性开关。例如tuple.ts、tuple-more.ts、tuple-errors.ts会通过parserTestFeatures映射为Feature.MultiValue后再解析第 57-61、71-76 行。这提示我们在新增涉及实验特性的 parser 测试时需要关注 runner 中的特性开关逻辑。常用命令# 运行全部 parser 测试 npm run test:parser # 只运行某一个测试testName 不带 .ts 后缀 npm run test:parser -- testNameWithoutTs # 重新生成重建所有 Fixture npm run test:parser -- --create # 重新生成某一个测试的 Fixture npm run test:parser -- testNameWithoutTs --createnpm run test:parser在 package.json 中对应node --enable-source-maps tests/parser即直接以 ESM 方式执行上面分析的 runner 入口。一条 parser 测试的典型形态在 tests/parser 目录中每个测试由两个文件成对出现测试源如class.ts、decorators.ts、enum.tsFixture如class.ts.fixture.ts、decorators.ts.fixture.ts、enum.ts.fixture.ts。Fixture 文件的命名约定是源文件名.ts.fixture.ts。它保存了重新序列化后的源码 诊断注释是 parser 测试的黄金基准。新建测试时先创建.ts源文件再运行npm run test:parser -- testNameWithoutTs --create生成首个 Fixture随后人工检查 Fixture 内容是否符合预期。Compiler 测试编译-校验-解释执行目录与原理Compiler 测试分为两个区域通用目录tests/compiler标准库专用目录tests/compiler/std其工作原理是读取测试源文件并解析、编译为 WebAssembly 模块校验validate模块合法性将模块转换为WebAssembly 文本格式.wat将文本输出与 Fixture 对比在WebAssembly VM中解释执行该模块验证运行时行为。针对运行时行为的断言可以使用内置的assert。需要特别留意的是编译器默认开启了 tree-shaking树摇/死代码消除因此测试中若希望某些函数被保留并可从外部调用可能需要显式导出入口点export entry points否则相关代码可能被优化掉导致运行时行为无法验证。除了主 Fixture 外编译器测试还会生成优化后模块的额外 Fixture如.debug.wat、.release.wat但这些仅用于可视化确认visual confirmation only不作为通过/失败的唯一依据——主对比基准是未优化的文本输出。在 tests/compiler 目录中可以直观看到这套 Fixture 体系每个.ts源文件通常伴随.name.debug.wat、.name.release.wat、.name.json等文件例如binary.ts对应binary.debug.wat、binary.release.wat与binary.json。错误检查.json 文件中的精确子串匹配当测试用例预期编译失败时错误检查的机制是在对应的.json文件中提供一组精确的错误消息子串运行时代码必须按顺序依次出现这些子串。以 tests/compiler/avoid-resolve-loop.json 为例{ asc_flags: [], stderr: [ AS225: Expression cannot be represented by a type., TS2448: Variable avoid-resolve-loop/e used before its declaration., TS2322: Type void is not assignable to type auto., AS225: Expression cannot be represented by a type. ] }asc_flags传递给 asc 编译器的额外命令行标志stderr预期按序出现的错误/警告子串列表编译器的实际 stderr 输出必须严格包含这些子串顺序匹配。同时README 指出如果设置了stderr配置项测试会跳过模块的实例化与运行Using thestderrconfig option will skip instantiating and running the module。也就是说一旦用例声明了 stderr 子串测试只关心编译期诊断不再执行运行时逻辑——这对于纯错误用例如binary-error.ts、constructor-errors.ts、memory-config-errors.ts等尤其合理。自定义运行时逻辑preInstantiate 与 postInstantiate可选地可以为测试添加一个与测试文件同名的.js文件其中包含在模块实例化前后运行的代码。该文件需要按以下导出签名提供两个钩子preInstantiate(imports: object, exports: object): void在模块实例化之前调用。用途是为测试填充 imports 中所需的功能。注意exports参数此时是一个空对象实例化完成后才会被真实导出填充——这意味着该钩子适合import 需要回调 export的场景通常配合--exportStart标志使用。postInstantiate(instance: WebAssembly.Instance): void在模块就绪后调用用于执行自定义测试逻辑。如果该函数抛出错误则实例化测试失败。仓库中的真实例子是 tests/compiler/external.js它配合 tests/compiler/external.ts 使用export function preInstantiate(imports, exports) { imports.external { foo: function() { /* nop */ }, foo.bar: function() { /* nop */ }, bar: function() { /* nop */ } }; imports.foo { baz: function() { /* nop */ }, var: 3 }; }对应的测试源通过external装饰器声明外部导入export declare function foo(): void; // external , foo external(bar) export declare function two(): void; // external , bar external(foo, baz) export declare function three(): void; // foo , baz external(foo, var) // foo , var export declare const var_: i32;这里preInstantiate为imports.external与imports.foo填充了 JS 函数与常量验证了external装饰器含external(module, name)双参数形式与 import 名字空间之间的对应关系。其余几个使用.js伴生文件的测试还有bigint-integration.js、declare.js、exportimport-table.js、mutable-globals.js可作为参考模板。常用命令# 运行全部 compiler 测试 npm run test:compiler # 只运行某一个测试testName 不带 .ts 后缀 npm run test:compiler -- testNameWithoutTs # 重新生成重建所有 Fixture npm run test:compiler -- --create # 重新生成某一个测试的 Fixture npm run test:compiler -- testNameWithoutTs --createnpm run test:compiler对应node --enable-source-maps --no-warnings tests/compiler见 package.json而总入口npm test会串行执行test:parser、test:compiler -- --parallel、test:browser、test:asconfig、test:transform与test:cli说明 compiler 测试还支持--parallel并行模式。新建/更新 compiler 测试的完整流程新建执行npm run clean确保基于源码而非构建产物测试在 tests/compiler或标准库用例放 tests/compiler/std下创建testName.ts编写测试代码。若预期编译失败同步创建testName.json并填写stderr子串若需要自定义运行时逻辑创建testName.js并导出preInstantiate/postInstantiate执行npm run test:compiler -- testName --create生成首批 Fixture人工检查生成的 Fixture.wat、.json等内容是否与预期完全一致。更新执行npm run clean修改testName.ts以及必要时同步修改.json/.js执行npm run test:compiler -- testName --create刷新 Fixture人工核对 Fixture 中变化的部分是否正是本次改动所期望的结果。实验特性测试ASC_FEATURES 环境变量实验特性experimental features的测试默认是禁用的它们通常需要通过--enableCLI 标志开启。开启方式有两种设置环境变量ASC_FEATURES为逗号分隔的特性名列表设置ASC_FEATURES*一次性启用全部特性。特性名的权威清单位于 tests/features.json当前仓库中包含特性名asc 标志v8 标志宿主运行参数threads--enable threads--experimental-wasm-threadsreference-types--enable reference-types无gc--enable gc--experimental-wasm-gcexception-handling--enable exception-handling无simd--enable simd无relaxed-simd--enable relaxed-simd--experimental-wasm-relaxed-simdfeatures.json同时记录了每条特性对应的asc_flags传给 asc 的开关与v8_flags测试运行环境中 v8/Wasm 运行时需要的实验标志这解释了为什么某些特性如threads、gc、relaxed-simd不仅需要编译器侧开启还需要宿主运行时具备对应能力。在 tests/compiler/features 目录下可以看到与这些特性对应的测试用例。在生成覆盖率报告前也建议按 README 的提示启用全部相关特性以免遗漏分支。代码覆盖率基于 c8 的报告仓库提供了可选的代码覆盖率报告生成方式npm install c8 npm run coverage覆盖率运行基于c8并使用编译器的JS 变体JS variant而非 Wasm 变体执行测试预期 Wasm 独占的分支会显示为未覆盖untaken这是正常现象不是缺陷建议在跑覆盖率前先按上文方式启用全部相关特性以获得更完整的分支覆盖生成的 HTML 报告输出到coverage/目录便于浏览器查看。npm run coverage在 package.json 中定义为npx c8 -- npm test即对完整测试套件进行插桩统计。如果你新增了 parser/compiler 测试覆盖率报告中对应分支的命中情况可以作为测试充分性的参考。其他测试目录不自动运行、无需更新README 特别说明其他目录中的测试不会被自动运行也不需要随源码改动更新 Fixture。它们包括tests/allocators内存分配器memory allocator测试套件覆盖默认分配器与 stub 分配器场景配合 tests/allocators/index.js 与 tests/allocators/runner.js 运行tests/browser.js通过 asc 的 API 检查典型浏览器使用方式tests/tokenizer.js一个tokenizer 分词自身的可视化测试visual test。这些目录的测试定位与 parser/compiler 测试不同——前者是快照对比型回归测试后者是独立的运行时/集成型测试因此维护节奏也不同。总结测试贡献的检查清单综合 tests/README.md 与仓库内 tests/parser.js、tests/compiler/external.js、tests/features.json、package.json 等实现向 AssemblyScript 提交 parser/compiler 相关改动时建议按如下清单自检运行npm run clean后再测试确保基于源码新建.ts测试源于正确目录parser 用例进 tests/parsercompiler 用例进 tests/compiler标准库用例进 tests/compiler/std按需补充.json错误子串 /stderr与.jspreInstantiate/postInstantiate伴生文件用--create生成 Fixture并逐项核对生成结果涉及实验特性时通过ASC_FEATURES开启对应特性参考 tests/features.json提交前运行相关测试命令验证通过必要时用npm run coverage检查分支覆盖。掌握这套源码 自动 Fixture 精确 diff的测试范式你就能在保障编译器正确性的前提下安全地为 AssemblyScript 增加新的语言特性或修复解析/编译缺陷。赞分享编译器编程语言语言运行时标准库【免费下载链接】assemblyscriptA TypeScript-like language for WebAssembly.项目地址https://gitcode.com/gh_mirrors/as/assemblyscript点击查看免费下载相关推荐KuboIPFSSharness 测试体系全指南从覆盖矩阵到用例编写实战KuboIPFSSharness 测试体系全指南从覆盖矩阵到用例编写实战 Kubo 是 Go 语言实现的 IPFS 节点包含守护进程、CLI、HTTP网络存储后端SQLFluff 测试体系完全指南从 fixture 驱动的方言解析测试到 100% 覆盖率规则测试SQLFluff 测试体系完全指南从 fixture 驱动的方言解析测试到 100% 覆盖率规则测试 SQLFluff 是一款支持 25 SQL 方言、采用代码质量Lint格式化静态分析开发工具LibreChat测试贡献编写测试用例与提高测试覆盖率LibreChat测试贡献编写测试用例与提高测试覆盖率 引言 在开源项目开发中测试是确保代码质量和稳定性的关键环节。LibreChat作为一个功能丰富的Ch人工智能大模型AI 应用交互助手上一篇WeatherMaster离线模式揭秘无网络环境下如何保持天气数据访问下一篇告别跨平台开发噩梦Abseil助你轻松构建高性能C应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考