This Angular TDD is an example of Angular App build with running tests in mind.
You can clone this repository and use it as a basis for your app, or use it to learn about Test Driven Development with Angular.
- Clone or unzip the Git repository to your workstation.
- Install dependencies with npm install; bower install;
- Install Karma dependencies globally with
npm install -g karma karma-cli karma-protractor karma-coverage istanbul webdriver-manager mocha - Run the application using the instructions in the Gulp seciton.
/app/ // where our app is
--/scripts/ // location of our app logic
--/index.html
/test/ // tests files
--/coverage/ // generated folder by istanbul
--/e2e/ // end to end tests
--/spec/ // unit tests for app
--/protractor.config.js/ // set up for protractor
--/server.spec.js/ // server unit tests
/karma.conf.js // karma setup
To run tests and then serve if the tests pass, run gulp (default task)
To generate and then view your code coverage report, run gulp coverage
Tests can be debugged in the browser by serving them with gulp serve-test
To automatically run Selenium and run your e2e tests, run gulp protractor
To run all unit tests in every configured browser, run gulp test-browser
To run each tests suite without them conflicting, run gulp test
To test the express server, run gulp test-server
To serve the app, run gulp serve (also runs tests)
DOM-less simple JavaScript testing framework A test runner/assertion/mocking utility combination. Use: Run tests, write assertions and mock functionality. Compare To: Mocha+Chai
Just a test runner. Often used in combination with an assertion library (see Assert, Chai) Compare to: Jasmine
The main goal for Karma is to bring a productive testing environment to developers. The environment being one where they don't have to set up loads of configurations, but rather a place where developers can just write the code and get instant feedback from their tests.
Karma is a browser test runner.
The idea is that browsers do not have natively a concept of loading tests files, running them, and reporting results. What karma does is (roughly):
- Start a small web server to serve "client-side" javascript files to be tested (1)
- Also serve the "client-side" javascript files with the tests (or Specs, as they're often called) (2) -serve a custom web page that will run javascript code for the tests (3)
- Start a browser to load this page (4)
- Report the results of the test to the server (5)
- Karma can then again report the results to text files, the console, anything your CI server likes, etc...
Use: Karma can be used to run your tests in browsers. If your tests are simple JavaScript that would run the same in Node as in Chrome, this is not necessary, but if you wish to support Firefox, Chrome, IE, et al, in your tests, Karma lets you do it, via a configuration file. Compare To: N/A
Use: Automate tasks. Environment: Command Line / JavaScript Compare to: Grunt, Broccoli
Use: Simplify automation of running Karma in Gulp
Environment: require this library in a gulpfile
Compare to: gulp-jasmine
A framework specifically for running tests on servers created by Express or similar APIs. Use: Require supertest in your test script and have it run tests on your Server script Compare to: Request.js
A tool for measuring how much of your code has tests covering it. Use: Compare to: N/A
MVC Framework. Use: Build single-page apps or augment static apps Compare to: Ember, React
A library necessary to run tests on your angular app. Has an e2e version that can only be run on the backend.
Use: Include the script on your page to gain access to inject and module
Compare to: N/A
A library for running end-to-end tests on angular apps. protractor uses selenium/webdriver, which are two big words. Use: Test high level functionality like database interaction and navigation
Assertion framework. Allows assertions to be written in expect.to.be form. Adds additional assertions to assert library.
Use: Write assertions in a descriptive way
Compare to: assert
A library built in to Node that can run certain assertions. Use: Use to write tests that can throw errors if code returns unexpected results. Compare to: Chai