ngx-testing-tools
v2.4.0
Published
Makes Angular testing easier
Downloads
26
Maintainers
Readme
In a nutshell
This library aims to reduce boilerplate 😎 and provides high-level tools️ 🔥 for testing Component, Service, Interceptor and everything else related to the Angular mechanism.
It makes tests easier to read 😌 and faster to write ⚡️!
Quick examples
Testing Component
describe('AppComponent', () => {
const tb = componentTestBed(AppComponent) // 🛠️ Create the test bed which is re-compiled for each test
.inject('prefs', Preferences); // 🖇️ Link a key to an injection for all tests, see below 👇
it('should render title', tb(({ component, query }) => { // 🔋 Access enhanced tools for testing components
expect(component.title).toEqual('app-v17');
const span = query.findElement('.content span');
expect(span.textContent).toContain('app-v17 app is running!');
}));
it('should update preferences on click', tb(({ action, injected: { prefs } }) => { // 🤯 Retrieve injections by autocompletion
expect(prefs.approved).toBeFalse();
action.click('#my-button');
expect(prefs.approved).toBeTrue();
}));
});
🫡 (The redundant "should create" test is even called up for you!)
Testing Service
describe('AppService', () => {
const tb = serviceTestBed(AppService, { httpTesting: true }); // 🛠️ Create the test bed and enable http testing
it('should fetch cat fact', tb(({ service, http, rx }, done) => {
const mockRes = { fact: 'string', length: 6 };
rx.remind = service.getCatFact().subscribe({ // 🧯 Use rx.remind to auto unsubscribe after the end of the test
next: (res) => {
expect(res).toEqual(mockRes);
done();
},
});
http.emitSuccessResponse({ url: service.CAT_FACT_URL, body: mockRes }); // 🎭 Fake the http response of the request that matches the url
}));
});
Installation
npm install --save-dev ngx-testing-tools
Documentation
Visit the docs at https://remscodes.github.io/ngx-testing-tools.
Demo
Check demo .spec.ts
files.
Version compatibility
Compatible with Angular >= 15.2.x
.
What's next ? 🤩
- More custom test beds :
RouterTestBed
- Mocks
- Angular schematics
License
MIT © Rémy Abitbol.