Native Request

v1.1 has been released

Native Request is a simple module that makes you create native node.js requests supports https.

• supports HTTPS
• 0 dependencies
• use callbacks

Table of Contents

Installation
Usage

Planned features

• 1.2.0: Proxy management

Installation

Install the dependencies and devDependencies and start the server.

1npm install native-request

Usage

JSON request (recommended)

• request.request(options, callback)

Easy

1let request = require('native-request');
2
3request.request({
4        url: "http://github.com/",
5        method: 'POST',
6    }, function(err, data, status, headers) {
7        console.log(status); //200
8        console.log(data); // page content
9        console.log(headers); // response headers
10});
11

Full

1let request = require('native-request');
2
3request.request({
4        url: "http://github.com/",
5        method: 'POST',
6        Cookies: { john: "doe", human: true },
7        headers: {
8            authorization: "Token121"
9        },
10        requestOptions: {
11            followRedirect: false,
12            maxRedirect: 1,
13            trustRedirect: false
14        }
15
16    }, function(err, data, status, headers) {
17        console.log(status); //200
18        console.log(data); // page content
19        console.log(headers); // response headers
20});
21

Parameters

Options	Required	Type	Parameters	Default
url	✓	String	Target url
method	✓	String	HTTP method to use. More info here
Headers		JSON Object	Pass headers to the request with a JSON format.	{"content-type": "application/json"}
Cookies		JSON Object	Pass cookies to the request with a JSON format
requestOptions		See below

RequestOptions

The parameters below are here for client configuration. None of these parameters will be sent. These parameters must be put in the object 'requestOptions'

Options	Required	Type	Parameters	Default
followRedirect		boolean	Decide if we should follow the redirects	true
maxRedirect		int	Decide the maximum number of redirects allowed	3
trustRedirect		boolean	If false, headers will not be sent when a redirect happen	true

GET request

• request.get(path, headers, callback)
• request.get(path, callback)

1let request = require('native-request');
2request.get('https://github.com', function(err, data, status, headers) {
3    if (err) {
4        throw err;
5    }
6    console.log(status); //200
7    console.log(data); // page content
8    console.log(headers); // response headers
9});

To add custom headers just do like this:

1let request = require('native-request');
2
3let headers = {
4    "content-type": "plain/text"
5}
6request.get('https://github.com', headers, function(err, data, status, headers) {
7    if (err) {
8        throw err;
9    }
10    console.log(status); //200
11    console.log(data); // page content
12    console.log(headers); // response headers
13});

POST request

• request.post(path, callback)

• request.post(path, data, callback)

• request.post(path, data, headers, callback)

To send an empty post:

1let request = require('native-request');
2request.post('https://github.com', function(err, data, status, headers) {
3    if (err) {
4        throw err;
5    }
6    console.log(status); //200
7    console.log(data); // page content
8    console.log(headers); // response headers
9});

With headers and data:

1let request = require('native-request');
2
3let data = {
4    "example": true,
5}
6let headers = {
7    "content-type": "plain/text"
8}
9request.post('https://github.com', data, headers, function(err, data, status, headers) {
10    if (err) {
11        throw err;
12    }
13    console.log(status); //200
14    console.log(data); // page content
15    console.log(headers); // response headers
16});

License

MIT. Copyright (c) Samuel Marchese.