http_miracle_mock

Description:

http miracle mock

简体中文 | English


http_miracle_mock #
Designed for Flutter unit testing, this library allows for easy mocking/intercepting of network requests and images within business logic.
Intercepting network requests in unit tests of Flutter projects is a common scenario. Existing frameworks include:

mockito: Not concise enough, requiring a large amount of code.
http_mock_adapter: Only supports the Dio library.
network_image_mock: Only supports image.

The purpose of this library is to solve the following problems:

Easy to use.
Compatible with mainstream networking frameworks, such as dio and http.
Deals only with network-related issues, such as common network requests and image resources.

Getting Started #
Adding Dependency #
dev_dependencies:
http_miracle_mock: any
copied to clipboard
Simple Usage #
Mocking a GET request:
void main() async {
TestWidgetsFlutterBinding.ensureInitialized();
final HttpMiracleMock httpMiracleMock = HttpMiracleMock();
final httpClient = HttpClient();
test('test getUrl', () async {
var url = 'https://example.com/create';
var data = "resultGetUrl";
var uri = Uri.parse(url);
httpMiracleMock.open(url).reply(data);
final request = await httpClient.getUrl(uri);
final response = await request.close();
var responseData = await response.transform(utf8.decoder).join();
expect(responseData, data);
});
}
copied to clipboard
Mocking a image:
testWidgets('test image using url png', (WidgetTester tester) async {
var data = File(path.join(Utils.currentPath, 'test', 'assets', 'test.png'));
var url = 'http://example.com/image.png';
httpMiracleMock.open(url).reply(data.readAsBytesSync());
await Utils.pumpWidgetWithImages(
tester,
Column(
children: [
Container(
child: Image.network(
url,
width: 100,
height: 100,
)),
],
),
[NetworkImage(url)],
);
await tester.pumpAndSettle();
await expectLater(
find.byType(Column),
matchesGoldenFile('snapshots/net_work_image_1.png'),
);
});
copied to clipboard
First, initialize the HttpMiracleMock, then use httpMiracleMock.open to provide the information needed to intercept the network request, such as request URL and parameters, and then use reply to enter the result of the request.
For more usage examples, refer to here.
API #
For simplicity, the library provides only the HttpMiracleMock object, which offers an open interface.
open #
The open method is primarily used to define the information for the request to be intercepted, with the following parameters:

url: Required, the request URL to intercept, can be passed in as a String, RegExp, or Uri.
method: Optional, the request method to intercept (GET/POST).
data: Optional, the request parameters.
dataTransform: Optional, for request parameter transformation, in case some requests cannot parse the parameters due to compatibility issues, this callback can be used for custom conversion.

The method, data,and dataTransform are optional parameters. In some cases, such as when the URL uses a regular expression, it may match multiple different requests in the project; these additional parameters can be used to differentiate and make the match more accurate.
This method returns a ResponseData.
reply #

body: Required, the data content to return.
statusCode: Optional, the status code to return.
headers: The header information to return.