fusion-framework-testing

Fusion Framework Testing

When to use

Use when writing or running a Vitest test for a Fusion Framework React app — a hook, component, route, or complete app — or when setting up/troubleshooting the test project itself.

Typical triggers:

• "Write a test for this component / hook / route"
• "Set up vitest.config.ts for this app"
• "Why does this test hang / hit the network / fail to resolve the app?"
• "Should this be a hook test or a component test?"
• "Share seeded fixtures across a test file"
• "Migrate this suite off Testing Library / jsdom"

Implicit triggers:

• A test file imports @equinor/fusion-framework-vitest-plugin-react-app (or its /test, /config sub-paths)
• vitest.config.ts needs Browser Mode, Playwright, or app-file resolution configured
• A test renders a component/hook that reads useAppModule, useFramework, or similar

When not to use

• Seeding module-specific state (a signed-in user, current context, feature flags, HTTP responses) — use fusion-framework-mocking; this skill only covers rendering/running the test
• dev-server.config.ts API mocking/proxying for local ffc app dev — dev-time only, see fusion-developer-app
• Non-Fusion test suites, or backend/service-repo tests

Required inputs

Mandatory

• What is under test: pure function, hook, component, route, or complete app
• Whether the project already has vitest.config.ts configured for this package

Conditional

• Whether the test needs a specific signed-in user, seeded context, or faked HTTP response (then hand off to fusion-framework-mocking for the seeding details)
• Whether several test files need the same fixture defaults

Instructions

Step 1 — Choose the smallest layer for the behavior under test

Fusion test utilities substitute external boundaries only; Vitest still owns the runner, assertions, lifecycle hooks, spies, timers, and coverage.

Testing intent	Start with	Import
Pure function or framework-independent hook	Standard Vitest	vitest
React hook that consumes app modules	renderAppHook	@equinor/fusion-framework-vitest-plugin-react-app
React component, route, or complete app	test/render fixture	@equinor/fusion-framework-vitest-plugin-react-app/test
Reusable app fixture without automatic app-file resolution	testApp	@equinor/fusion-framework-vitest-plugin-react-app
App module configuration without React	mockAppModules	see fusion-framework-mocking
Parent framework or portal-level modules	mockFramework	see fusion-framework-mocking
One method call, timer, global, or JS module	Vitest's vi APIs	vitest