mockito 3.0.0-beta+1 copy "mockito: ^3.0.0-beta+1" to clipboard
mockito: ^3.0.0-beta+1 copied to clipboard

outdatedDart 1 only

A mock framework inspired by Mockito.

3.0.0-beta+1 #

  • Upgrade package dependencies.

3.0.0-beta #

  • This release is the first 3.0.0 release featuring the new Mockito 3 API. The README has been updated, and an upgrading-to-mockito-3 doc has been added to help users upgrade. Here's a quick rundown:

    // Old API:
    when(obj.fn(typed(any)))...
    // New API:
    when(obj.fn(any))...
    
    // Old API:
    when(obj.fn(foo: typed(any, named: 'foo')))...
    // New API:
    when(obj.fn(foo: anyNamed('foo')))...
    
    // Old API:
    when(obj.fn(foo: typed(null, named: 'foo')))...
    // New API:
    when(obj.fn(foo: argThat(isNull, named: 'foo')))...
    

3.0.0-alpha+5 #

  • Fix compatibility with new noSuchMethod Forwarding feature of Dart 2. This is thankfully a mostly backwards-compatible change. This means that this version of Mockito should continue to work:

    • with Dart >=2.0.0-dev.16.0,
    • with Dart 2 runtime semantics (i.e. with dart --preview-dart-2, or with Flutter Beta 3), and
    • with the new noSuchMethod Forwarding feature, when it lands in CFE, and when it lands in DDC.

    This change, when combined with noSuchMethod Forwarding, will break a few code paths which do not seem to be frequently used. Two examples:

    class A {
      int fn(int a, [int b]) => 7;
    }
    class MockA extends Mock implements A {}
    
    var a = new MockA();
    when(a.fn(typed(any), typed(any))).thenReturn(0);
    print(a.fn(1));
    

    This used to print null, because only one argument was passed, which did not match the two-argument stub. Now it will print 0, as the real call contains a value for both the required argument, and the optional argument.

    a.fn(1);
    a.fn(2, 3);
    print(verify(a.fn(typed(captureAny), typed(captureAny))).captured);
    

    This used to print [2, 3], because only the second call matched the verify call. Now, it will print [1, null, 2, 3], as both real calls contain a value for both the required argument, and the optional argument.

3.0.0-alpha+4 #

  • Introduce a backward-and-forward compatible API to help users migrate to Mockito 3. See more details in the upgrading-to-mockito-3 doc.

3.0.0-alpha+3 #

  • thenReturn and thenAnswer now support generics and infer the correct types from the when call.
  • Completely remove the mirrors implementation of Mockito (mirrors.dart).

3.0.0-alpha+2 #

  • Support stubbing of void methods in Dart 2.

3.0.0-alpha #

  • thenReturn now throws an ArgumentError if either a Future or Stream is provided. thenReturn calls with futures and streams should be changed to thenAnswer. See the README for more information.

2.2.0 #

  • Add new feature to wait for an interaction: untilCalled. See the README for documentation.
  • capture* calls outside of a verify* call no longer capture arguments.
  • Some collections require stricter argument matching. For example, a stub like: mock.methodWithListArgs([1,2,3].map((e) => e*2)) (note the Iterable argument) will no longer match the following stub: when(mock.methodWithListArgs([42])).thenReturn(7);.

2.1.0 #

  • Add documentation for when, verify, verifyNever, resetMockitoState.
  • Expose throwOnMissingStub, resetMockitoState.
  • Improve failure message for verify.
  • SDK version ceiling bumped to <2.0.0-dev.infinity to support Dart 2.0 development testing.
  • Add a Mockito + test package example at test/example/iss.

2.0.2 #

  • Start using the new InvocationMatcher instead of the old matcher.
  • Change throwOnMissingStub back to invoking Object.noSuchMethod:
    • It was never documented what the thrown type should be expected as.
    • You can now just rely on throwsNoSuchMethodError if you want to catch it.

2.0.1 #

  • Add a new throwOnMissingStub method to the API.

2.0.0 #

  • Removed mockito_no_mirrors.dart

2.0.0-dev #

  • Remove export of spy and any dart:mirrors based API from mockito.dart. Users may import as package:mockito/mirrors.dart going forward.
  • Deprecated mockito_no_mirrors.dart; replace with mockito.dart.
  • Require Dart SDK >=1.21.0 <2.0.0 to use generic methods.

1.0.1 #

  • Add a new thenThrow method to the API.
  • Document thenAnswer in the README.
  • Add more dartdoc.

1.0.0 #

  • Add a new typed API that is compatible with Dart Dev Compiler; documented in README.md.

0.11.1 #

  • Move the reflection-based spy code into a private source file. Now package:mockito/mockito.dart includes this reflection-based API, and a new package:mockito/mockito_no_mirrors.dart doesn't require mirrors.

0.11.0 #

  • Equality matcher used by default to simplify matching collections as arguments. Should be non-breaking change in most cases, otherwise consider using argThat(identical(arg)).

0.10.0 #

  • Added support for spy.

0.9.0 #

  • Migrate from the unittest package to use the new test package.
  • Format code using dartformat