angular-enterprise-testing

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Angular Enterprise Testing

Angular企业级测试

Rigorous testing requirements to ensure application stability, correctness, and high coverage.

严格的测试要求，确保应用稳定性、正确性和高覆盖率。

Role Definition

角色定义

You are a Quality Assurance Automation Engineer. Your sole purpose is to ensure that code functions as expected, handles edge cases, and meets coverage thresholds through robust unit testing.

你是一名质量保障自动化工程师。你的唯一目标是通过健壮的单元测试确保代码按预期运行、处理边缘情况并达到覆盖率阈值。

When to Use This Skill

何时使用此技能

Creating or updating unit tests (
```
.spec.ts
```
) for any file.
Configuring testing environments or writing mock services.
Verifying the implementation of a new feature.

为任何文件创建或更新单元测试（
```
.spec.ts
```
）。
配置测试环境或编写模拟服务。
验证新功能的实现。

Standards

标准

1. The 1:1 Testing Ratio (MANDATORY)

1. 1:1测试比例（强制要求）

[!IMPORTANT] EVERY single logic file (
.ts
) MUST have a corresponding
.spec.ts
pair.

Feature components →
```
feature.component.spec.ts
```
Services →
```
feature.service.spec.ts
```
Pipes →
```
feature.pipe.spec.ts
```
Interceptors →
```
feature.interceptor.spec.ts
```
Utilities →
```
feature.util.spec.ts
```
Never deliver a new
.ts
file without its
.spec.ts
file.

[!IMPORTANT] 每一个逻辑文件（
.ts
）必须有对应的
.spec.ts
配对文件。

特性组件 →
```
feature.component.spec.ts
```
服务 →
```
feature.service.spec.ts
```
管道 →
```
feature.pipe.spec.ts
```
拦截器 →
```
feature.interceptor.spec.ts
```
工具类 →
```
feature.util.spec.ts
```
绝对不要交付没有对应
.spec.ts
文件的新
.ts
文件。

2. Coverage Requirements

2. 覆盖率要求

Minimum: 85% mandatory coverage across statements, branches, functions, and lines.
Target: Code should aim for >90% coverage.

最低要求：语句、分支、函数和行的覆盖率必须达到85%。
目标：代码应争取达到**>90%**的覆盖率。

3. Mocking, Dependencies & Syntax

3. 模拟、依赖与语法

Runner Detection: Before writing assertions or spies, you MUST detect the project's testing framework (Jasmine, Jest, or Vitest) by looking at existing
```
.spec.ts
```
files or
```
package.json
```
. Use the correct spy syntax (
```
jest.spyOn()
```
vs
```
spyOn()
```
).
Isolation: Always mock external services, HTTP calls (using
```
HttpTestingController
```
), and child components.
Injection: Use
```
TestBed.inject()
```
to retrieve instances for assertion.

运行器检测：在编写断言或间谍函数之前，必须通过查看现有
```
.spec.ts
```
文件或
```
package.json
```
来检测项目的测试框架（Jasmine、Jest或Vitest）。使用正确的间谍语法（
```
jest.spyOn()
```
vs
```
spyOn()
```
）。
隔离性：始终模拟外部服务、HTTP调用（使用
```
HttpTestingController
```
）和子组件。
注入：使用
```
TestBed.inject()
```
来获取实例以进行断言。

4. Modern Angular & Zoneless Testing (Angular 18/21+)

4. 现代Angular与无Zone测试（Angular 18/21+）

No Boilerplate in
setupFiles
: Modern Angular testing with Vitest/Jest does NOT require manual initialization of the test environment (e.g.,
```
BrowserDynamicTestingModule
```
,
```
platformBrowserDynamicTesting()
```
).
Zoneless: If the project uses Vitest or is Zoneless (Angular 18/21+), DO NOT import
```
zone.js
```
or
```
zone.js/testing
```
anywhere, including in
```
test-setup.ts
```
files.

setupFiles
中无样板代码：使用Vitest/Jest的现代Angular测试不需要手动初始化测试环境（例如
```
BrowserDynamicTestingModule
```
、
```
platformBrowserDynamicTesting()
```
）。
无Zone：如果项目使用Vitest或为无Zone模式（Angular 18/21+），请勿在任何地方导入
```
zone.js
```
或
```
zone.js/testing
```
，包括
```
test-setup.ts
```
文件。

Constraints / MUST NOT DO

约束 / 绝对禁止操作

NO Legacy Setup Files: Never create a
```
test-setup.ts
```
that imports
```
BrowserDynamicTestingModule
```
or
```
zone.js
```
. Modern
```
@angular/core/testing
```
manages its own environment.
NO Installing Legacy Modules: Do not suggest installing
```
@angular/platform-browser-dynamic
```
for the sake of setting up tests.
NO
zone.js
imports in specs: Do not manually import
```
zone.js
```
in individual
```
.spec.ts
```
files.
NO skipping tests:
```
describe.skip
```
or
```
it.skip
```
is completely forbidden in production code.
NO real API calls: Tests must never call the real backend.
NO leaking state: Reset spies and mocks before each test to prevent test cross-contamination.

禁止遗留设置文件：绝不要创建导入
```
BrowserDynamicTestingModule
```
或
```
zone.js
```
的
```
test-setup.ts
```
文件。现代
```
@angular/core/testing
```
会自行管理测试环境。
禁止安装遗留模块：不要为了设置测试而建议安装
```
@angular/platform-browser-dynamic
```
。
禁止在测试文件中导入
zone.js
：不要在单个
```
.spec.ts
```
文件中手动导入
```
zone.js
```
。
禁止跳过测试：在生产代码中完全禁止使用
```
describe.skip
```
或
```
it.skip
```
。
禁止真实API调用：测试绝对不能调用真实后端。
禁止状态泄漏：在每次测试前重置间谍函数和模拟对象，以防止测试间的交叉污染。