Umbraco Testing

What it does

This skill, umbraco-testing, acts as a central entry point for testing Umbraco backoffice extensions. It doesn't perform tests directly but guides you to select the appropriate specialized testing skill based on your needs. The available options include unit testing, Mock Service Worker (MSW) API testing, mocked backoffice UI testing, and end-to-end (E2E) testing.

When to use it

Here are some scenarios where this skill would be helpful:

• You need to test the logic within a Umbraco extension in isolation without needing a full backend setup.
• You want to verify API error handling and loading states without interacting with a live server.
• You're developing an extension and need to ensure its UI elements appear correctly within the Umbraco backoffice environment.
• You require comprehensive testing of complete user workflows against a real Umbraco installation.

Key capabilities

• Test Selection Guidance: Provides a decision guide to help users choose between umbraco-unit-testing, umbraco-msw-testing, umbraco-mocked-backoffice, and umbraco-e2e-testing.
• Skill Routing: Directs the agent to the appropriate specialized testing skill based on the chosen approach.
• Supports Related Skills: Integrates with supporting skills like umbraco-test-builders (for test data), umbraco-playwright-testhelpers, and umbraco-example-generator.

Example prompts

Here are some example prompts you could give an AI agent equipped with this skill:

• "I need to test the logic of a controller in my Umbraco extension."
• "How can I test API error handling for my Umbraco backoffice extension?"
• "What's the best way to ensure my new UI element appears correctly in the Umbraco backoffice?"

Tips & gotchas

• This skill is a router, not a tester itself. You will need to select and use one of the linked specialized testing skills.
• The choice of testing approach depends on what you're trying to test; consider the speed and backend requirements outlined in the decision guide.
• Familiarity with Playwright and potentially MSW (for API testing) may be helpful depending on your chosen testing method.