61 lines
2.7 KiB
Markdown
61 lines
2.7 KiB
Markdown
# Angel3 Test
|
|
|
|
|
|
[](https://dart.dev/null-safety)
|
|
[](https://discord.gg/3X6bxTUdCM)
|
|
[](https://github.com/dart-backend/angel/tree/master/packages/test/LICENSE)
|
|
|
|
Testing utility library for Angel3 framework.
|
|
|
|
## TestClient
|
|
|
|
The `TestClient` class is a custom `angel3_client` that sends mock requests to your server. This means that you will not have to bind your server to HTTP to run. Plus, it is an `angel3_client`, and thus supports services and other goodies. The `TestClient` also supports WebSockets. WebSockets cannot be mocked (yet!) within this library, so calling the `websocket()` function will also bind your server to HTTP, if it is not already listening. The return value is a `WebSockets` client instance (from [`package:angel3_websocket`](<https://pub.dev/packages/angel3_websocket>));
|
|
|
|
```dart
|
|
var ws = await client.websocket('/ws');
|
|
ws.service('api/users').onCreated.listen(...);
|
|
|
|
// To receive all blobs of data sent on the WebSocket:
|
|
ws.onData.listen(...);
|
|
```
|
|
|
|
## Matchers
|
|
|
|
Several `Matcher`s are bundled with this package, and run on any `package:http` `Response`, not just those returned by Angel.
|
|
|
|
```dart
|
|
void test('foo', () async {
|
|
var res = await client.get('/foo');
|
|
expect(res, allOf([
|
|
isJson({'foo': 'bar'}),
|
|
hasStatus(200),
|
|
hasContentType(ContentType.JSON),
|
|
hasContentType('application/json'),
|
|
hasHeader('server'), // Assert header present
|
|
hasHeader('server', 'angel'), // Assert header present with value
|
|
hasHeader('foo', ['bar', 'baz']), // ... Or multiple values
|
|
hasBody(), // Assert non-empty body
|
|
hasBody('{"foo":"bar"}') // Assert specific body
|
|
]));
|
|
});
|
|
|
|
void test('error', () async {
|
|
var res = await client.get('/error');
|
|
expect(res, isAngelHttpException());
|
|
expect(res, isAngelHttpException(statusCode: 404, message: ..., errors: [...])) // Optional
|
|
});
|
|
```
|
|
|
|
`hasValidBody` is one of the most powerful `Matcher`s in this library, because it allows you to validate a JSON body against a validation schema. Angel3 provides a comprehensive [validation library](<https://pub.dev/packages/angel3_validate>) that integrates tightly with the `matcher` package that you already use for testing.
|
|
|
|
```dart
|
|
test('validate response', () async {
|
|
var res = await client.get('/bar');
|
|
expect(res, hasValidBody(Validator({
|
|
'foo': isBoolean,
|
|
'bar': [isString, equals('baz')],
|
|
'age*': [],
|
|
'nested': someNestedValidator
|
|
})));
|
|
});
|
|
```
|