angular_test 2.0.0-alpha+10

Testing runner and library for AngularDart

angular_test

Testing infrastructure AngularDart, used with the build_runner package.

Documentation and examples:

• _tests/test/ (tests for the main dart-lang/angular package)
• AngularDart component testing documentation:
  • Running Component Tests
  • Component Testing: Basics
  • Pages for individual topics, such as page objects and user actions

NOTE: Some of the guides above are out of date the for the latest angular_test versions.

Additional resources:

• API reference
• Community/support: mailing list, Gitter chat room
• GitHub repo (dart-lang/angular): source code, test issues
• Pub packages: angular_test, build_runner, test

Overview

angular_test is a library for writing tests for AngularDart components.

// Assume this is 'my_test.dart'.
import 'my_test.template.dart' as ng;

void main() {
  ng.initReflector();
  tearDown(disposeAnyRunningTest);

  test('should render "Hello World"', () async {
    final testBed = new NgTestBed<HelloWorldComponent>();
    final testFixture = await testBed.create();
    expect(testFixture.text, 'Hello World');
    await testFixture.update((c) => c.name = 'Universe');
    expect(testFixture.text, 'Hello Universe');
  });
}

@Component(selector: 'test', template: 'Hello {{name}}')
class HelloWorldComponent {
  String name = 'World';
}

To use angular_test, configure your package's pubspec.yaml as follows:

dev_dependencies:
  build_runner: ^0.8.0
  build_test: ^0.10.0
  build_web_compilers: ^0.4.0

IMPORTANT: angular_test will not run without these dependencies set.

To run tests, use pub run build_runner test. It automatically compiles your templates and annotations with AngularDart, and then compiles all of the Dart code to JavaScript in order to run browser tests. Here's an example of using Chrome with Dartdevc:

pub run build_runner test -- -p chrome

For more information using pub run build_runner test, see the documentation: https://github.com/dart-lang/build/tree/master/build_runner#built-in-commands