1.1.1 • Published 7 months ago
al-http-request v1.1.1
#Http request support for cookies, headers, query parameters, and request bodies.
Installation
Before using this module, install the necessary dependencies:
npm install al-http-request
Usage
Import the function
import { req } from 'al-http-request';
Perform a Request
The req
function supports the following options:
method
(optional): HTTP method (GET
,POST
,PUT
,DELETE
). Default:GET
.headers
(optional): Object of headers.cookies
(optional): Object of cookies.params
(optional): Query parameters.body
(optional): Request payload (JSON format).
Example: GET Request with Query Parameters
const response = await req('https://example.com/api', {
params: { search: 'term', limit: 10 },
});
console.log(response.content);
Example: POST Request with Headers, Cookies, and Body
const response = await req('https://example.com/login', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
cookies: { session: 'abc123' },
body: { username: 'user', password: 'pass' },
});
console.log(response.content);
Example: Handle Errors
try {
const response = await req('https://example.com/404');
console.log(response.content);
} catch (error) {
console.error(error.message);
}
Features
- Cookies: Automatically managed using
tough-cookie
. - Headers: Pass custom headers as an object.
- Query Parameters: Add query parameters easily.
- JSON Body: Pass a JSON payload for POST/PUT requests.
License
This module is free to use for educational and personal projects.