使用 Mockito 模拟依赖项

1. 添加包依赖项
2. 创建一个测试函数
3. 使用模拟 http.Client 创建一个测试文件
4. 为每个条件编写测试
5. 运行测试
完整示例
总结

有时，单元测试可能依赖于从实时 Web 服务或数据库获取数据的类。这由于以下几个原因而不便

调用实时服务或数据库会减慢测试执行速度。
如果 Web 服务或数据库返回意外结果，通过的测试可能会开始失败。这被称为“不稳定测试”。
使用实时 Web 服务或数据库很难测试所有可能的成功和失败场景。

因此，与其依赖实时 Web 服务或数据库，您可以“模拟”这些依赖项。模拟允许模拟实时 Web 服务或数据库，并根据情况返回特定结果。

一般来说，您可以通过创建类的替代实现来模拟依赖项。您可以手动编写这些替代实现，或者使用 Mockito 包作为快捷方式。

本示例演示了使用 Mockito 包进行模拟的基本步骤，包括以下步骤：

添加包依赖项。
创建一个要测试的函数。
创建一个包含模拟 http.Client 的测试文件。
为每种情况编写测试。
运行测试。

有关更多信息，请参阅 Mockito 包文档。

要使用 mockito 包，请将其添加到 pubspec.yaml 文件的 dev_dependencies 部分，并添加 flutter_test 依赖项。

本示例还使用 http 包，因此请在 dependencies 部分定义该依赖项。

mockito: 5.0.0 支持 Dart 的空安全，这得益于代码生成。要运行所需的代码生成，请在 dev_dependencies 部分添加 build_runner 依赖项。

要添加依赖项，请运行 flutter pub add

flutter pub add http dev:mockito dev:build_runner

在本示例中，我们将对从互联网获取数据食谱中的 fetchAlbum 函数进行单元测试。要测试此函数，请进行以下两个更改：

向函数提供一个 http.Client。这允许根据情况提供正确的 http.Client。对于 Flutter 和服务器端项目，请提供一个 http.IOClient。对于浏览器应用程序，请提供一个 http.BrowserClient。对于测试，请提供一个模拟 http.Client。
使用提供的 client 从互联网获取数据，而不是使用静态 http.get() 方法，因为该方法难以模拟。

该函数现在应该如下所示：

dartFuture<Album> fetchAlbum(http.Client client) async {
  final response = await client
      .get(Uri.parse('https://jsonplaceholder.typicode.com/albums/1'));

  if (response.statusCode == 200) {
    // If the server did return a 200 OK response,
    // then parse the JSON.
    return Album.fromJson(jsonDecode(response.body) as Map<String, dynamic>);
  } else {
    // If the server did not return a 200 OK response,
    // then throw an exception.
    throw Exception('Failed to load album');
  }
}

在您的应用程序代码中，您可以使用 fetchAlbum(http.Client()) 直接向 fetchAlbum 方法提供一个 http.Client。http.Client() 创建一个默认的 http.Client。

接下来，创建一个测试文件。

按照单元测试简介食谱中的建议，在根 test 文件夹中创建一个名为 fetch_album_test.dart 的文件。

在主函数中添加注释 @GenerateMocks([http.Client]) 以使用 mockito 生成一个 MockClient 类。

生成的 MockClient 类实现了 http.Client 类。这允许您将 MockClient 传递给 fetchAlbum 函数，并在每次测试中返回不同的 http 响应。

生成的模拟将位于 fetch_album_test.mocks.dart 中。导入此文件以使用它们。

dartimport 'package:http/http.dart' as http;
import 'package:mocking/main.dart';
import 'package:mockito/annotations.dart';

// Generate a MockClient using the Mockito package.
// Create new instances of this class in each test.
@GenerateMocks([http.Client])
void main() {
}

接下来，运行以下命令生成模拟

dart run build_runner build

fetchAlbum() 函数执行以下两种操作之一

如果 http 调用成功，则返回一个 Album
如果 http 调用失败，则抛出一个 Exception

因此，您需要测试这两种情况。使用 MockClient 类为成功测试返回“Ok”响应，为不成功测试返回错误响应。使用 Mockito 提供的 when() 函数测试这些条件。

dartimport 'package:flutter_test/flutter_test.dart';
import 'package:http/http.dart' as http;
import 'package:mocking/main.dart';
import 'package:mockito/annotations.dart';
import 'package:mockito/mockito.dart';

import 'fetch_album_test.mocks.dart';

// Generate a MockClient using the Mockito package.
// Create new instances of this class in each test.
@GenerateMocks([http.Client])
void main() {
  group('fetchAlbum', () {
    test('returns an Album if the http call completes successfully', () async {
      final client = MockClient();

      // Use Mockito to return a successful response when it calls the
      // provided http.Client.
      when(client
              .get(Uri.parse('https://jsonplaceholder.typicode.com/albums/1')))
          .thenAnswer((_) async =>
              http.Response('{"userId": 1, "id": 2, "title": "mock"}', 200));

      expect(await fetchAlbum(client), isA<Album>());
    });

    test('throws an exception if the http call completes with an error', () {
      final client = MockClient();

      // Use Mockito to return an unsuccessful response when it calls the
      // provided http.Client.
      when(client
              .get(Uri.parse('https://jsonplaceholder.typicode.com/albums/1')))
          .thenAnswer((_) async => http.Response('Not Found', 404));

      expect(fetchAlbum(client), throwsException);
    });
  });
}

现在您已经有了带有测试的 fetchAlbum() 函数，请运行测试。

flutter test test/fetch_album_test.dart

您还可以按照单元测试简介食谱中的说明，在您喜欢的编辑器中运行测试。

dartimport 'dart:async';
import 'dart:convert';

import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;

Future<Album> fetchAlbum(http.Client client) async {
  final response = await client
      .get(Uri.parse('https://jsonplaceholder.typicode.com/albums/1'));

  if (response.statusCode == 200) {
    // If the server did return a 200 OK response,
    // then parse the JSON.
    return Album.fromJson(jsonDecode(response.body) as Map<String, dynamic>);
  } else {
    // If the server did not return a 200 OK response,
    // then throw an exception.
    throw Exception('Failed to load album');
  }
}

class Album {
  final int userId;
  final int id;
  final String title;

  const Album({required this.userId, required this.id, required this.title});

  factory Album.fromJson(Map<String, dynamic> json) {
    return Album(
      userId: json['userId'] as int,
      id: json['id'] as int,
      title: json['title'] as String,
    );
  }
}

void main() => runApp(const MyApp());

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late final Future<Album> futureAlbum;

  @override
  void initState() {
    super.initState();
    futureAlbum = fetchAlbum(http.Client());
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Fetch Data Example',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
      ),
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Fetch Data Example'),
        ),
        body: Center(
          child: FutureBuilder<Album>(
            future: futureAlbum,
            builder: (context, snapshot) {
              if (snapshot.hasData) {
                return Text(snapshot.data!.title);
              } else if (snapshot.hasError) {
                return Text('${snapshot.error}');
              }

              // By default, show a loading spinner.
              return const CircularProgressIndicator();
            },
          ),
        ),
      ),
    );
  }
}

dartimport 'package:flutter_test/flutter_test.dart';
import 'package:http/http.dart' as http;
import 'package:mocking/main.dart';
import 'package:mockito/annotations.dart';
import 'package:mockito/mockito.dart';

import 'fetch_album_test.mocks.dart';

// Generate a MockClient using the Mockito package.
// Create new instances of this class in each test.
@GenerateMocks([http.Client])
void main() {
  group('fetchAlbum', () {
    test('returns an Album if the http call completes successfully', () async {
      final client = MockClient();

      // Use Mockito to return a successful response when it calls the
      // provided http.Client.
      when(client
              .get(Uri.parse('https://jsonplaceholder.typicode.com/albums/1')))
          .thenAnswer((_) async =>
              http.Response('{"userId": 1, "id": 2, "title": "mock"}', 200));

      expect(await fetchAlbum(client), isA<Album>());
    });

    test('throws an exception if the http call completes with an error', () {
      final client = MockClient();

      // Use Mockito to return an unsuccessful response when it calls the
      // provided http.Client.
      when(client
              .get(Uri.parse('https://jsonplaceholder.typicode.com/albums/1')))
          .thenAnswer((_) async => http.Response('Not Found', 404));

      expect(fetchAlbum(client), throwsException);
    });
  });
}

在本例中，您学习了如何使用 Mockito 测试依赖于 Web 服务或数据库的函数或类。这只是对 Mockito 库和模拟概念的简要介绍。有关更多信息，请参阅 Mockito 包提供的文档。

使用 Mockito 模拟依赖项

1. 添加包依赖项

2. 创建一个测试函数

3. 创建一个包含模拟 `http.Client` 的测试文件

4. 为每个条件编写测试

5. 运行测试

完整示例

lib/main.dart

test/fetch_album_test.dart

总结