Testing

Testing

Dart already has fantastic testing support, through a library of testing helpers that will make test writing faster. The following functions are exported by package:angel_test, and will make your testing much easier.

connectTo

Full definition

This function will start app on an available port, and return a TestClient instance (based on package:angel_client) configured to send requests to the server. The client also supports session manipulation.

1. main() {
2. TestClient client;

4. setUp(() async {
5. client = await connectTo(myApp);
6. });

8. // Shut down server, and cancel pending requests
9. tearDown(() => client.close());

11. test('hello', () async {
12. // The server URL is automatically prepended to paths.
13. // This returns an http.Response. :)
14. var response = await client.get('/hello');
15. });
16. }

isJson

A Matcher that asserts that the given http.Response equals value when decoded as JSON. This uses test.equals internally, so anything that would pass that matcher passes this one.

hasStatus

A Matcher that asserts the given http.Response has the given status code.

More Matchers

The complete set of angel_test Matchers can be found here.

Next Up…

  1. Find out how to handle errors in an Angel application.
  2. Learn how to use the handy Angel CLI.