// Quick-reference for running Ignite UI for Angular test suites. Covers the full test run (`test:lib`), grid-specific suites (grid, tree-grid, hierarchical-grid, pivot-grid), non-grid tests, watch mode, and auxiliary test suites (schematics, styles, i18n). Use when an agent needs to run, select, or understand the test infrastructure. Do NOT use for building — use igniteui-angular-build instead. Do NOT use for linting — use igniteui-angular-linting instead.
Quick-reference for running Ignite UI for Angular test suites. Covers the full test run (`test:lib`), grid-specific suites (grid, tree-grid, hierarchical-grid, pivot-grid), non-grid tests, watch mode, and auxiliary test suites (schematics, styles, i18n). Use when an agent needs to run, select, or understand the test infrastructure. Do NOT use for building — use igniteui-angular-build instead. Do NOT use for linting — use igniteui-angular-linting instead.
user-invocable
true
Ignite UI for Angular — Testing
Quick-reference card for the core test commands for the main igniteui-angular library plus schematics, styles, and i18n suites.
Prerequisites
Run npm install at the repo root.
Schematics tests normally run from source and do not require a build first. Only run npm run build:schematics and npm run build:migrations when you specifically want to validate the compiled schematics or migrations output.
For performance tests: run npm run build:lib first, or at minimum npm run build:styles, because test:lib:perf loads dist/igniteui-angular/styles/igniteui-angular.css.
Test Runner
Karma + Jasmine for all library unit tests.
Karma configs live in projects/igniteui-angular/karma*.conf.js.
Coverage reports are written to coverage/.
Choosing the Right Command
Scenario
Command
All library tests (slow — runs everything)
npm run test:lib
Flat grid tests only
npm run test:lib:grid
Tree grid tests only
npm run test:lib:tgrid
Hierarchical grid tests only
npm run test:lib:hgrid
Pivot grid tests only
npm run test:lib:pgrid
All non-grid tests (components, directives, services)
npm run test:lib:others
Watch mode (re-runs on file changes, for dev loop)
npm run test:lib:watch
Performance tests
npm run test:lib:perf
Schematics + migrations
npm run test:schematics
Sass/style logic
npm run test:styles
i18n resource validation
npm run test:i18n
Decision Guide
Working on a grid component? → Use the matching grid command (test:lib:grid, test:lib:tgrid, test:lib:hgrid, or test:lib:pgrid).
Working on a non-grid component or directive? → Use test:lib:others.
Iterating quickly during development? → Use test:lib:watch.
Edited a migration or schematic? → Use test:schematics. Build first only if you also need to validate compiled output.
Running performance tests? → Build first (build:lib or at least build:styles), then use test:lib:perf.
Changed Sass theme logic? → Use test:styles.
Changed i18n resource strings? → Use test:i18n.
Final verification before marking work complete? → Use test:lib (full suite).
