request/request-promise
Request Promise
Ce projet est un client HTTP basé sur les promesses pour Node.js qui enveloppe les requêtes réseau de style callback en objets promesse. Il sert de bibliothèque pour envoyer des JSON, des données de formulaire et des requêtes multipart vers des serveurs web tout en gérant le contrôle de flux asynchrone.
La bibliothèque utilise une implémentation de promesse Bluebird spécialisée pour gérer les cycles de vie des requêtes et des réponses. Elle inclut un gestionnaire de session qui utilise un cookie jar pour maintenir et transmettre l'état à travers plusieurs appels réseau.
L'outil couvre un large éventail de capacités réseau, incluant l'intégration d'API REST, la transformation de données de réponse et la capture complète de réponse HTTP. Il fournit des mécanismes pour l'annulation de requête, la gestion d'erreur configurable pour les codes de statut non-succès, et le débogage du trafic réseau.
Features
- Promise-Based HTTP Clients - Wraps callback-style HTTP requests into promise objects to manage asynchronous network flow without nesting.
- Asynchronous HTTP Calls - Enables making asynchronous HTTP requests using promises instead of traditional callbacks for simplified error and response handling.
- REST API Integrations - Sending and receiving JSON data through HTTP requests to communicate with web services and external application interfaces.
- HTTP Cookie Management - Manages session state across multiple network calls using a cookie jar to handle session cookies.
- Request Body Encoders - Provides mechanisms to encode request bodies as JSON, URL-encoded forms, or multipart data for standard web transfers.
- Node.js HTTP Clients - Serves as a comprehensive Node.js library for sending JSON, form data, and multipart requests to web servers.
- Session & Cookie Handlers - Uses a cookie jar to store and send cookies across multiple requests to maintain session state.
- Web Session Management - Maintains state across multiple network calls by storing and sending cookies using a cookie jar.
- Callback-to-Promise Converters - Transforms standard Node.js error-first callbacks into promise resolve and reject states for consistent async handling.
- Request Body Attachers - Transforms JavaScript objects into JSON or multipart form data strings before transmission over the network.
- API Error Handling - Allows configuration to determine if the promise should reject based on HTTP status codes or only on network failures.
- HTTP Response Processors - Captures full response objects and transforms raw body data into specific formats for application use.
- Request Cancellations - Provides the ability to abort active network requests to stop associated processes from resolving or rejecting.
- Configurable Promise Resolutions - Allows callers to decide whether non-success HTTP status codes trigger a promise rejection or a resolution.
- Full Response Captures - Enables returning the complete HTTP response object, including status codes and headers, instead of only the response body.
- API Response Transformations - Implements custom functions to transform raw response bodies into different formats before they are used by the application.
