#includeSource

• 类型： string[]
• 默认值： []

源码内联测试（In-source testing）指的是测试代码与源代码写在同一个文件中，类似于 Rust 的模块测试。

你可以通过 includeSource 配置，定义一组用于匹配内联测试文件的 glob 模式列表。

import { defineConfig } from '@rstest/core';

export default defineConfig({
  includeSource: ['src/**/*.{js,ts}'],
});

#编写内联测试

当定义了 includeSource 后，Rstest 会运行所有通过 glob 匹配且包含 import.meta.rstest 的文件。

你可以通过 import.meta.rstest 获取 Rstest 的测试 API。

export const sayHi = () => 'hi';

if (import.meta.rstest) {
  const { it, expect } = import.meta.rstest;
  it('should test source code correctly', () => {
    expect(sayHi()).toBe('hi');
  });
}

#生产环境构建

将测试代码写在 if (import.meta.rstest) 代码块内，并在你的构建配置（如 rsbuild.config.ts）中将 import.meta.rstest 定义为 false，这样将有助于打包工具消除无用代码。

import { defineConfig } from '@rsbuild/core';

export default defineConfig({
  source: {
    define: {
+      'import.meta.rstest': false,
    },
  },
});

#TypeScript

如需让 TypeScript 支持 import.meta.rstest，你可以创建一个 src/rstestEnv.d.ts 文件来引用：

/// <reference types="@rstest/core/importMeta" />