typo3-testing

Category: Ops & Delivery | Uploader: netresearch | Downloads: 0 | Version: v1.0（Latest）

Use when setting up TYPO3 extension test infrastructure, writing unit/functional/E2E/architecture tests, configuring PHPUnit, testing time-dependent code, mutation testing, mocking dependencies, configuring CI/CD for TYPO3 extensions, or debugging failing tests in CI (including multi-version TYPO3 v13/v14 test failures).

Changelog: Source: GitHub https://github.com/netresearch/typo3-testing-skill

Directory Structure

Current level: skills/typo3-testing/

📁 assets/
- 📁 Build/
  - 📁 playwright/
    
    📁 tests/
    
    📁 playwright/
    
    📁 accessibility/
    
    📄 modules.spec.ts 2.0 KB
    
    📁 e2e/
    
    📄 backend-module.spec.ts 1.7 KB
    
    📁 fixtures/
    
    📄 setup-fixtures.ts 2.7 KB
    
    📁 helper/
    
    📄 login.setup.ts 975 B
    
    📄 config.ts 712 B
    
    📄 .nvmrc 6 B
    
    📄 package.json 535 B
    
    📄 playwright.config.ts 1.3 KB
  - 📁 Scripts/
    
    📄 runTests.sh 20.2 KB
- 📁 docker/
  - 📄 codeception.yml 979 B
  - 📄 docker-compose.yml 1.4 KB
- 📁 example-tests/
  - 📄 ExampleAcceptanceCest.php 2.2 KB
  - 📄 ExampleFunctionalTest.php 2.4 KB
  - 📄 ExampleUnitTest.php 1.6 KB
- 📁 fixtures/
  - 📄 be_users.csv 361 B
  - 📄 pages.csv 257 B
  - 📄 README.md 2.0 KB
  - 📄 sys_category.csv 228 B
  - 📄 tt_content.csv 338 B
- 📄 .php-cs-fixer.dist.php 7.0 KB
- 📄 AGENTS.md 5.0 KB
- 📄 bootstrap.php 1.4 KB
- 📄 codecov.yml 1.6 KB
- 📄 FunctionalTests.xml 1.4 KB
- 📄 FunctionalTestsBootstrap.php 1.6 KB
- 📄 github-actions-e2e.yml 8.5 KB
- 📄 github-actions-tests.yml 5.4 KB
- 📄 infection.json5 2.3 KB
- 📄 Makefile 2.3 KB
- 📄 phpat.neon 330 B
- 📄 phpat.php 8.4 KB
- 📄 phpstan-baseline.neon 365 B
- 📄 phpstan.neon 1.4 KB
- 📄 rector.php 2.9 KB
- 📄 UnitTests.xml 890 B
- 📄 UnitTestsBootstrap.php 2.1 KB
📁 references/
- 📄 accessibility-testing.md 7.5 KB
- 📄 architecture-testing.md 2.7 KB
- 📄 asset-templates-guide.md 3.3 KB
- 📄 ci-cd.md 16.7 KB
- 📄 ci-debugging.md 6.5 KB
- 📄 crypto-testing.md 14.9 KB
- 📄 ddev-testing.md 10.6 KB
- 📄 e2e-testing.md 30.1 KB
- 📄 enforcement-rules.md 3.5 KB
- 📄 functional-test-patterns.md 5.9 KB
- 📄 functional-testing.md 25.1 KB
- 📄 fuzz-testing.md 8.5 KB
- 📄 integration-testing.md 12.7 KB
- 📄 javascript-testing.md 19.5 KB
- 📄 mutation-testing.md 9.5 KB
- 📄 performance-testing.md 9.5 KB
- 📄 quality-tools.md 13.9 KB
- 📄 sonarcloud.md 10.2 KB
- 📄 test-runners.md 9.9 KB
- 📄 typo3-v14-final-classes.md 9.8 KB
- 📄 unit-testing.md 40.9 KB
📁 scripts/
- 📄 generate-test.sh 4.9 KB
- 📄 setup-testing.sh 5.9 KB
- 📄 validate-setup.sh 3.8 KB
📄 checkpoints.yaml 8.6 KB
📄 SKILL.md 3.9 KB

SKILL.md

---
name: typo3-testing
description: "Use when setting up TYPO3 extension test infrastructure, writing unit/functional/E2E/architecture tests, configuring PHPUnit, testing time-dependent code, mutation testing, mocking dependencies, configuring CI/CD for TYPO3 extensions, or debugging failing tests in CI (including multi-version TYPO3 v13/v14 test failures)."
---

# TYPO3 Testing Skill

Templates, scripts, and references for comprehensive TYPO3 extension testing.

## Test Type Selection

| Type | Use When | Speed |
|------|----------|-------|
| **Unit** | Pure logic, no DB, validators, utilities | Fast |
| **Functional** | DB interactions, repositories, controllers | Medium |
| **Architecture** | Layer constraints, dependency rules (phpat) | Fast |
| **E2E (Playwright)** | User workflows, browser, accessibility | Slow |
| **Integration** | HTTP client, API mocking, OAuth flows | Medium |
| **Fuzz** | Security, parsers, malformed input | Manual |
| **Crypto** | Encryption, secrets, key management | Fast |
| **Mutation** | Test quality verification, 70%+ coverage | CI/Release |

## Setup and Running Tests

```bash
# Setup
<skill-dir>/scripts/setup-testing.sh [--with-e2e]   # Initialize testing
<skill-dir>/scripts/validate-setup.sh               # Validate existing setup
<skill-dir>/scripts/generate-test.sh <Type> <Class> # Generate test file

# Run tests
Build/Scripts/runTests.sh -s unit          # Unit tests
Build/Scripts/runTests.sh -s functional    # Functional tests
Build/Scripts/runTests.sh -s architecture  # Architecture tests (phpat)
Build/Scripts/runTests.sh -s e2e           # E2E tests (Playwright)
Build/Scripts/runTests.sh -s lint          # Linting
Build/Scripts/runTests.sh -s phpstan       # Static analysis
Build/Scripts/runTests.sh -s mutation      # Mutation testing
```

After creating or modifying a test, **always verify** it fails before the fix and passes after. Run the full suite to ensure no regressions.

## Scoring Requirements

| Criterion | Requirement |
|-----------|-------------|
| Unit tests | Required, 70%+ coverage |
| Functional tests | Required for DB operations |
| Architecture tests | **phpat required** for full points |
| PHPStan | Level 10 (max) |

## References

| Reference | Topic |
|-----------|-------|
| `unit-testing.md` | UnitTestCase, mocking, FakeClock |
| `functional-testing.md` | FunctionalTestCase, CSV fixtures, **TSFE limitations** |
| `functional-test-patterns.md` | PHPUnit 10+ migration, container reset |
| `integration-testing.md` | PSR-18 mocking, OAuth flows |
| `e2e-testing.md` | Playwright, Page Object Model |
| `ddev-testing.md` | Local multi-version matrix |
| `test-runners.md` | runTests.sh, Docker orchestration |
| `architecture-testing.md` | phpat, layer constraints |
| `ci-debugging.md` | **Multi-version CI failure analysis** |
| `ci-cd.md` | GitHub Actions, GitLab CI |
| `quality-tools.md` | PHPStan, PHP-CS-Fixer, Rector |
| `mutation-testing.md` | Infection, MSI |
| `typo3-v14-final-classes.md` | Interface extraction, mock strategies |
| `javascript-testing.md` | Jest, frontend testing |
| `enforcement-rules.md` | E2E CI rules, troubleshooting |

All references in `references/` directory.

### Explicit Content Triggers

When debugging CI test failures across TYPO3 versions, load `references/ci-debugging.md` for multi-version error comparison and debugging checklist.

When writing functional tests that need frontend context (parseFunc, typoLink, TSFE), load `references/functional-testing.md` for known limitations and workarounds.

## External Resources

- [TYPO3 Testing Documentation](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/Testing/)
- [Tea Extension](https://github.com/TYPO3BestPractices/tea) (reference implementation)
- [phpat documentation](https://github.com/carlosas/phpat)
- [Infection PHP documentation](https://infection.github.io/)
- [DDEV documentation](https://ddev.readthedocs.io/)

---

> **Contributing:** https://github.com/netresearch/typo3-testing-skill

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

typo3-testing

Directory Structure

SKILL.md

Report

Notice