4.0.0 • Published 3 days ago

phin v4.0.0

Weekly downloads
1,126,137
License
MIT
Repository
github
Last release
3 days ago

The lightweight Node.js HTTP client

Deprecation warning

Some version of this package are deprecated and should not be used. Ensure you are using a non-deprecated version.

See #91 for more information.

Simple Usage

const p = require('phin')

const res = await p('https://example.com')

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 phin

Why Phin?

Phin is relied upon by important projects and large companies. The hundreds of contributors at Less, for example, depend on Phin as part of their development process.

Also, Phin is very lightweight. To compare to other libraries, see Phin vs. the Competition.

Quick Demos

Simple POST:

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

Unpromisified Usage

const p = require('phin').unpromisified

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

Simple parsing of JSON:

// (In async function in this case.)

const res = await p({
	'url': 'https://example.com/',
	'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://example.com/somejson')
// ^ An options object could also be used here to set other options.

// Do things with res.body?

Custom Axios HTTP Options

Phin allows you to set Axios HTTP options.

await p({
	'url': 'https://example.com/name',
	'axiosOpts': {
		httpAgent: myAgent // Assuming you'd already created myAgent earlier.
	}
})

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:

PackageSize
requestrequest package size
superagentsuperagent package size
gotgot package size
axiosaxios package size
isomorphic-fetchisomorphic-fetch package size
r2r2 package size
node-fetchnode-fetch package size
phinphin package size
4.0.0

3 days ago

3.7.0

1 year ago

3.6.1

2 years ago

3.6.0

3 years ago

3.5.1

3 years ago

3.5.0

4 years ago

3.4.1

4 years ago

3.4.0

5 years ago

3.3.0

5 years ago

3.2.4

5 years ago

3.2.3

5 years ago

3.2.2

5 years ago

3.2.1

5 years ago

3.2.0

5 years ago

3.1.1

5 years ago

3.1.0

5 years ago

3.0.0

5 years ago

2.9.3

5 years ago

2.9.2

6 years ago

2.9.1

6 years ago

2.9.0

6 years ago

2.8.1

6 years ago

2.8.0

6 years ago

2.7.1

6 years ago

2.7.0

6 years ago

2.6.0

6 years ago

2.5.6

6 years ago

2.5.5

6 years ago

2.5.4

6 years ago

2.5.3

6 years ago

2.5.2

6 years ago

2.5.1

6 years ago

2.4.18

7 years ago

2.3.11

7 years ago

2.2.95

7 years ago

2.2.94

7 years ago

2.2.93

7 years ago

2.2.92

7 years ago

2.2.91

7 years ago

2.2.90

7 years ago

2.2.81

7 years ago

2.2.8

7 years ago

2.2.7

7 years ago

2.2.6

7 years ago

2.2.5

7 years ago

2.2.4

7 years ago

2.2.3

7 years ago

2.2.2

7 years ago

2.2.1

7 years ago

2.2.0

7 years ago

2.1.0

7 years ago

2.0.2

7 years ago

2.0.1

7 years ago

2.0.0

7 years ago

1.0.8

7 years ago

1.0.7

7 years ago

1.0.6

7 years ago

1.0.5

7 years ago

1.0.4

7 years ago

1.0.3

7 years ago

1.0.2

7 years ago

1.0.1

7 years ago

1.0.0

7 years ago

0.0.2

10 years ago

0.0.1

10 years ago