dart-lang/http
Http
This library provides a unified, cross-platform interface for executing HTTP requests and managing network communication in Dart applications. It functions as a composable client library that automatically resolves platform-specific network implementations, ensuring consistent behavior across mobile, desktop, and web environments.
The library distinguishes itself through a modular architecture that supports swappable transport layers and middleware, allowing developers to inject custom logic for logging, caching, or retries. It includes built-in support for resilient communication, such as configurable backoff strategies for handling temporary failures, and provides tools for mocking network traffic to facilitate reliable testing.
Beyond basic request execution, the library offers comprehensive support for persistent connection management, bidirectional WebSocket communication, and HTTP/2 protocols. It handles large data payloads through incremental stream-based processing to maintain memory efficiency and includes utilities for media type management, date formatting, and message serialization.
The project provides a standardized set of interfaces and diagnostic tools to monitor network traffic and verify implementation compliance. It is designed to be integrated into applications via dependency injection, enabling centralized control over network configurations and server endpoint aggregation.
Features
- Cross-Platform Networking - Provides a unified interface for performing network operations that automatically selects the appropriate platform-specific implementation for consistent behavior.
- Runtime Resolution Engines - Selects the appropriate underlying network engine at runtime based on the target environment like mobile, desktop, or web.
- Cross-Platform HTTP Clients - Builds consistent network communication layers that function seamlessly across mobile, desktop, and web environments using a unified interface.
- HTTP Client Libraries - Functions as a composable library for executing HTTP requests and managing network communication across mobile, desktop, and web platforms.
- HTTP Request Execution - Provides a composable interface for sending individual or persistent network requests, supporting both simple one-off calls and long-lived connections.
- Retry and Backoff Logic - Implements automated retry strategies and exponential backoff to handle network instability.
- Streaming Transfers - Handles large payloads and continuous data streams efficiently by processing network responses incrementally to prevent memory exhaustion.
- Bidirectional WebSocket Streaming - Provides a stream-based interface for establishing and managing bidirectional connections between clients and servers in a cross-platform environment.
- HTTP Payload Streaming - Processes large HTTP request and response bodies using incremental streams to maintain memory efficiency.
- HTTP/2 Support - Supports bidirectional communication channels using the HTTP/2 protocol, enabling efficient data streaming and multiplexed request handling.
- HTTP Message Serialization - Converts raw data into structured HTTP messages and serializes objects into standard HTTP formats for reliable cross-platform compatibility.
- Network Implementation Switching - Provides mechanisms to swap between platform-provided services and embedded library implementations for network operations.
- Protocol-Agnostic Interfaces - Provides a unified API for interacting with various network protocols including HTTP/1.1, HTTP/2, and WebSockets.
- Transport Abstraction Layers - Decouples high-level request logic from platform-specific network implementations using a swappable interface pattern.
- Persistent HTTP Connections - Maintains long-lived client sessions to reuse underlying network connections and reduce handshake overhead.
- Resilient Communication - Improves application reliability by implementing automatic retry strategies and configurable backoff logic for handling temporary network failures.
- WebSocket Managers - Provides a unified, stream-based interface for managing bidirectional WebSocket connections and state.
- Incremental Stream Processing - Handles large payloads incrementally as asynchronous byte streams to prevent memory exhaustion during network transfers.
- Composable Middleware Pipelines - Enables wrapping network clients with additional logic to handle concerns like retries, logging, or caching transparently.
- API Request Mocking - Intercepts network requests to simulate server responses and verify application behavior during testing.
- HTTP Testing Utilities - Provides tools for mocking network traffic and validating client compliance to ensure reliable application behavior during development.
