network_image_mock

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote utilitário para mockar respostas do Image.network em testes de widgets no Flutter. Permite aos desenvolvedores simular o carregamento de imagens de rede sem fazer solicitações HTTP reais, garantindo resultados de teste consistentes e confiáveis. Ideal para testar componentes da interface que exibem imagens de fontes remotas, fornece uma maneira simples de retornar imagens de espaço reservado ou ativos pré-definidos durante os testes. O pacote é leve e se integra perfeitamente com o framework de testes do Flutter.

Casos de uso

Testando widgets que exibem imagens remotas
Simulando estados de carregamento de imagem
Evitando chamadas de rede em testes unitários
Validando espaços reservados de imagem
Garantir a consistência do teste

Principais recursos

Respostas simuladas do Image.network
Suporta imagens de espaço reservado
Sem dependências de rede externa
Integração fácil com arquivos de teste
Funciona em todas as plataformas do Flutter

Indicado para

Desenvolvedores Flutter escrevendo testes de widget
Equipes que exigem ambientes de teste estáveis
Projetos com mudanças frequentes na interface envolvendo imagens
Engenheiros de automação de testes
pipelines de CI/CD

Considerações

Não destinado ao uso em produção
Requer configuração manual em arquivos de teste
Limitado a cenários de mock de imagem
Não gerencia o cache de imagem
Deve ser removido das dependências de produção

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Network Image Mock

GitHub code size in bytes

A utility for providing mocked response to Image.network in Flutter widget tests.

Introduction

Since you are here you probably already know that calling Image.network results in 400 response in Flutter widget tests. The reason for this is that default HTTP client in tests always return a 400.

So, what can we do about it? Instead of copying the whole code over and over again for mocking the HTTP client, I created this package. It is heavily inspired by roughike/image_test_utils, however that package is not being maintained despite multiple pull requests asking for bumping the mockito version and making the package usable again.

Installing

Null safety

This package should be installed under dev_dependencies with

dev_dependencies:
  network_image_mock: ^2.0.1

Without null safety (deprecated)

If you have legacy unmigrated code that does not use Null safety, install under dev_dependencies with

dev_dependencies:
  network_image_mock: 1.1.0

Example

The package is quite straightforward to use. All you have to do is include it in your test file and wrap widget testing functions that require proper Image.network response in mockNetworkImagesFor() function provided by this package. A full test example could look like this.

import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:network_image_mock/network_image_mock.dart';

Widget makeTestableWidget() => MaterialApp(home: Image.network(''));

void main() {
  testWidgets(
    'should properly mock Image.network and not crash',
    (WidgetTester tester) async {
      mockNetworkImagesFor(() => tester.pumpWidget(makeTestableWidget()));
    },
  );
}

This is actually an example taken from tests for this package.

Contributing

There is not much to contribute since the package serves its purpose, however, in chance of needing to bump or adjust some version, or any other suggestion for that matter, please read CONTRIBUTING.