network_image_mock

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Hilfspaket zum Mocken von Image.network-Antworten in Flutter-Widget-Tests. Es ermöglicht Entwicklern, das Laden von Netzwerk-Bildern ohne echte HTTP-Anfragen zu simulieren und so konsistente und zuverlässige Testergebnisse sicherzustellen. Ideal für die Prüfung von Benutzeroberflächenkomponenten, die Bilder aus entfernten Quellen anzeigen, bietet es eine einfache Möglichkeit, Platzhalterbilder oder vordefinierte Ressourcen während des Tests zurückzugeben. Das Paket ist leichtgewichtig und nahtlos mit dem Flutter-Testframework integriert.

Anwendungsfälle

Widgets testen, die entfernte Bilder anzeigen
Simulieren von Bild-Ladezuständen
Vermeidung von Netzwerkaufrufen in Einheitstests
Überprüfung von Bildplatzhaltern
Testkonsistenz sicherstellen

Hauptmerkmale

Mock-Antworten von Image.network
Unterstützt Platzhalterbilder
Keine externen Netzwerkabhängigkeiten
Einfache Integration mit Testdateien
Funktioniert auf allen Flutter-Plattformen

Geeignet für

Flutter-Entwickler, die Widget-Tests schreiben
Teams, die stabile Testumgebungen benötigen
Projekte mit häufigen UI-Änderungen, die Bilder betreffen
Test-Automatisierungsingenieure
CI/CD-Pipelines

Hinweise

Nicht für den Produktiveinsatz vorgesehen
Benötigt manuelle Einrichtung in Testdateien
Beschränkt auf Bildmocking-Szenarien
Behandelt keine Bildcaching
Muss aus Produktionsabhängigkeiten entfernt werden

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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.