dio

What's new

• Fix FormData.readAsBytes excessive memory usage with large payloads by replacing the O(n²) reduce+spread approach with a pre-allocated Uint8List.
• Fix request hanging indefinitely when async interceptor callbacks throw without calling the handler.
• Fix HttpException: Connection closed before full header was received being reported as DioExceptionType.unknown.
• Add transformTimeout to bound long-running response transformations, including background JSON decoding.
  On web, timeout handling is best-effort because synchronous JavaScript work cannot be preempted.
• Fix FormData.clone() dropping boundaryName and camelCaseContentDisposition, so a retried multipart request now keeps the original options instead of silently falling back to the defaults.
• Fix QueuedInterceptor stalling its queue forever when the active request is cancelled while its callback is still pending (never calls next/resolve/reject), which blocked every subsequent request routed through the interceptor.
• Fix ErrorInterceptorHandler.reject(..., true) not continuing to following error interceptors in queued interceptors.

• Fixes kIsWeb across different Flutter SDKs.
• Provides httpVersion in Response.extra when using IOHttpClientAdapter.

• Add requestUrl and responseUrl parameters to LogInterceptor for more precise control over URL logging.
• Fix QueuedInterceptor hanging indefinitely when interceptor callbacks throw synchronous exceptions.

• Do not allow updating the error field after a cancel token has canceled.
• Allow passing an initial interceptors list to the constructor of Interceptors.
• Use package:mime to help determine the content-type of MultipartFile base on the provided filename.

• Raise the version constraint of dio_web_adapter.

• Update comments and strings with MultipartFile.
• Removes redundant warnings when composing request options on Web.
• Fixes boundary inconsistency in FormData.clone().
• Support FileAccessMode in Dio.download and Dio.downloadUri to change download file opening mode.
• Fix ListParam equality by using the DeepCollectionEquality.
• Enables configuring the logging details of DioException globally and locally.
• Enables using Dio.clone to reuse base options, client adapter, interceptors, and transformer, in a new Dio instance.

• Graceful handling of responses with nonzero Content-Length, Content-Type that is json, and empty payload.
  • Empty responses are now transformed to null.

• Supports the WASM environment. Users should upgrade the adapter with dart pub upgrade or flutter pub upgrade to use the WASM-supported version.

• Raise the min Dart SDK version to 2.18.0.
• Add constructor for DioExceptionType.badCertificate.
• Create type alias DioMediaType for http_parser's MediaType.
• Fix the type conversion regression when using MultipartFile.fromBytes.
• Split the Web implementation to package:dio_web_adapter.
• Add FusedTransformer for improved performance when decoding JSON.
• Set FusedTransformer as the default transformer.
• Improves InterceptorState.toString().
• If the CancelToken got canceled before making requests, throws the exception directly rather than cut actual HTTP requests afterward.
• Catch MediaType parse exception in Transformer.isJsonMimeType.
• Improves warning logs on the Web platform.
• Improves memory allocating when using CancelToken.

• Fix WASM compile errors after moving the web implementation to dio_web_adapter.

• Remove sockets detach in IOHttpClientAdapter.
• Allows to define FormData.boundaryName instead of the default --dio-boundary-.

• Fix type promotions for the UTF-8 encoder on previous Dart SDKs.

• Fix receiveTimeout throws exception after the request has been cancelled.
• Catch sync/async exceptions in interceptors' handlers.
• Throws precise StateError for handler's duplicated calls.

• Revert "Catch sync/async exceptions in interceptors' handlers".

• Provide fix suggestions for dart fix.
• Fix receiveTimeout for streamed responses.
• Fix cancellation for streamed responses and downloads when using IOHttpClientAdapter.
• Fix receive progress for streamed responses and downloads when using IOHttpClientAdapter.
• Support relative baseUrl on the Web platform.
• Avoid fake uncaught exceptions during debugging with IDEs.

• Improve SyncTransformer's stream transform.
• Allow case-sensitive header keys with the preserveHeaderCase flag through options.
• Fix receiveTimeout for the IOHttpClientAdapter.
• Fix receiveTimeout for the download method of DioForNative.
• Improve the stream byte conversion.

• Raise warning for Maps other than Map<String, dynamic> when encoding request data.
• Improve exception messages.
• Allow ResponseDecoder and RequestEncoder to be async.
• Ignores Duration.zero timeouts.

• Fix failing requests throw DioExceptions with .unknown instead of .connectionError on SocketException.
• Removes the accidentally added options argument for Options.compose.
• Fix wrong formatting of multi-value header in BrowserHttpClientAdapter.
• Add warning in debug mode when trying to send data with a GET request in web.
• Reduce cases in which browsers would trigger a CORS preflight request.
• Add warnings in debug mode when using sendTimeout and onSendProgress with an empty request body.
• Fix receiveTimeout not working correctly on web.
• Fix ImplyContentTypeInterceptor can be removed by Interceptors.clear() by default.

• Revert removed download for DioMixin.
• Fix for Dio.download not cleaning the file on data handling error.

• Improve package descriptions and code formats.
• Improve comments.
• Fix error when cloning MultipartFile from FormData with regression test.
• Deprecate MultipartFile constructor in favor MultipartFile.fromStream.
• Add FormData.clone.

• Remove http from dev_dependencies.
• Add support for cloning MultipartFile from FormData.
• Only produce null response body when ResponseType.json.

• Revert changes to handling of List<int> body data.

• Fix changelog on pub.dev.

• Make LogInterceptor prints in DEBUG mode (when the assertion is enabled) by default.
• Deprecate DioError in favor of DioException.
• Fix IOHttpClientAdapter.onHttpClientCreate Repeated calls
• IOHttpClientAdapter.onHttpClientCreate has been deprecated and is scheduled for removal in Dio 6.0.0 - Please use the replacement IOHttpClientAdapter.createHttpClient instead.
• Using CancelToken no longer closes and re-creates HttpClient for each request when IOHttpClientAdapter is used.
• Fix timeout handling for browser receiveTimeout.
• Improve performance when sending binary data (List<int>/Uint8List).

• Fix DioErrorType deprecation hint.

• Allow FormData to send a null entry value as an empty string.

• Revert changes to CancelToken.cancel() behavior, as a result the DioError provided by the CancelToken.cancelError does not contain useful information when the token was not used with a request.
• Fix wrong ListFormat being used for comparison during encoding of FormData and application/x-www-form-urlencoded, resulting in potential wrong output encoding for ListFormat.multi and ListFormat.multiCompatible since Dio 4.0.x.
• Respect Options.listFormat when encoding x-www-url-encoded content.

• Fix double-completion when using connectionTimeout on web platform.
• Allow defining adapter methods through their constructors.
• Fix FormData encoding regression for maps with dynamic keys, introduced in 5.0.3.
• Mark several static DioMixin functions as @internal.
• Make DioError.stackTrace non-nullable.
• Ensure DioError.stackTrace always points to the correct call site.

• Imply List<Map> as JSON content in ImplyContentTypeInterceptor.
• Fix FormData encoding for collections and objects.

• Improve code formats according to linter rules.
• Remove the force conversion for the response body.
• Fix DioErrorType.cancel in Interceptors.
• Fix wrong encoding of collection query parameters.
• Fix "unsupported operation" error on web platform.

• Add ImplyContentTypeInterceptor as a default interceptor.
• Add Headers.multipartFormDataContentType for headers usage.
• Fix variable shadowing of withCredentials in browser_adapter.dart.

• Raise the min Dart SDK version to 2.15.0 to support BackgroundTransformer.
• Change Dio.transformer from DefaultTransformer to BackgroundTransformer.
• Remove plain ASCII check in FormData.
• Allow asynchronous method with savePath.
• Allow data in all request methods.
• A platform independent HttpClientAdapter can now be instantiated by doing dio.httpClientAdapter = HttpClientAdapter();.
• Add ValidateCertificate to handle certificate pinning better.
• Support Content-Disposition header case sensitivity.

Breaking Changes

• The default charset utf-8 in Headers content type constants has been removed.
• BaseOptions.setRequestContentTypeWhenNoPayload has been removed.
• Improve DioErrors. There are now more cases in which the inner original stacktrace is supplied.
• HttpClientAdapter must now be implemented instead of extended.
• Any classes specific to dart:io platforms can now be imported via import 'package:dio/io.dart';. Classes specific to web can be imported via import 'package:dio/browser.dart';.
• connectTimeout, sendTimeout, and receiveTimeout are now Durations.

• fix #1452

• require Dart 2.12.1 which fixes exception handling for secure socket connections (#45214)
• Only delete file if it exists when downloading.
• Fix BrowserHttpClientAdapter canceled hangs
• Correct JSON MIME Type detection
• [Web] support send/receive progress in web platform
• refactor timeout logic
• use 'arraybuffer' instead of 'blob' for xhr requests in web platform

• Fix fetching null data in a response

• fix #1311

• Add QueuedInterceptor
• merge #1316 #1317

• merge pr #1177 #1196 #1205 #1224 #1225 #1227 #1256 #1263 #1291
• fix #1257

stable version

• fix #1091 , #1089 , #1087

• fix #1082 and # 1076

Interceptors: Add handler for Interceptor APIs which can specify the subsequent interceptors processing logic more finely (whether to skip them or not).

• fix #1074

• fix #1070

• support ListParam

• fix #1060

• rename CollectionFormat to ListFormat
• change default value of Options.listFormat from multiCompatible to multi
• add upload_stream_test.dart

• support null-safety
• add CollectionFormat configuration in Options
• add fetch API for Dio
• rename DioErrorType enums from uppercase to camel style
• rename 'Options.merge' to 'Options.copyWith'

1. fix #877 'dio.interceptors.errorLock.lock()'
2. fix #851
3. fix #641

• Add test cases

• Code style improvement

• Merge #574 : fix upload image header error, support both oss and other server

• revert #562, and fixed #566

• merge #557 #531