Skip to content

Latest commit

 

History

History
143 lines (100 loc) · 3.69 KB

README.md

File metadata and controls

143 lines (100 loc) · 3.69 KB

phin logo


The ultra-lightweight Node.js HTTP client

This is a fork from Phin that adds support for HTTP agent.

Simple Usage

const p = require('phin')

const res = await p('https://ethanent.me')

console.log(res.body)

Note that the above should be in an async context! phin also provides an unpromisified version of the library.

Install

npm install agent-phin

Why phin?

phin is trusted by some really important projects. The hundreds of contributors at Less, for example, depend on phin as part of their development process.

Also, phin is super lightweight. Like 99.8% smaller than request lightweight. To compare to other libraries, see phin vs. the Competition.

Quick Demos

Simple POST:

await p({
	url: 'https://ethanent.me',
	method: 'POST',
	data: {
		hey: 'hi'
	}
})

Using KeepAlive agent:

const https = require('https');
const keepAliveAgent = new https.Agent({ keepAlive: true });

await p({
	url: 'https://ethanent.me',
	method: 'POST',
	data: {
		hey: 'hi'
	},
	agent: keepAliveAgent
})

Using agent for proxy:

const HttpsProxyAgent = require('https-proxy-agent');

const proxy = 'http://localhost:8008';
const agent = new HttpsProxyAgent(proxy);

await p({
	url: 'https://ethanent.me',
	method: 'POST',
	data: {
		hey: 'hi'
	},
	agent: agent
})

Unpromisified Usage

const p = require('phin').unpromisified

p('https://ethanent.me', (err, res) => {
	if (!err) console.log(res.body)
})

Simple parsing of JSON:

// (In async function in this case.)

const res = await p({
	url: 'https://ethanent.me/name',
	parse: 'json'
})

console.log(res.body.first)

Default options

const ppostjson = p.defaults({
	'method': 'POST',
	'parse': 'json',
	'timeout': 2000
})

// In async function...

const res = await ppostjson('https://ethanent.me/somejson')
// ^ An options object could also be used here to set other options.

// Do things with res.body?

Full Documentation

See the phin documentation.

phin vs. the Competition

phin is a very lightweight library, yet it contains all of the common HTTP client features included in competing libraries!

Here's a size comparison table:

Package Size
request request package size
superagent superagent package size
isomorphic-fetch isomorphic-fetch package size
axios axios package size
got got package size
r2 r2 package size
node-fetch node-fetch package size
snekfetch snekfetch package size
phin phin package size