request/request-promise
Request Promise
This project is a promise-based HTTP client for Node.js that wraps callback-style network requests into promise objects. It serves as a library for sending JSON, form data, and multipart requests to web servers while managing asynchronous flow control.
The library utilizes a specialized Bluebird promise implementation to handle request and response lifecycles. It includes a session manager that uses a cookie jar to maintain and transmit state across multiple network calls.
The tool covers a broad range of network capabilities, including REST API integration, response data transformation, and full HTTP response capture. It provides mechanisms for request cancellation, configurable error handling for non-success status codes, and network traffic debugging.
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.
