kiss-request

A simple and stupid node request wrapper.

Usage no npm install needed!

<script type="module">
  import kissRequest from 'https://cdn.skypack.dev/kiss-request';
</script>

README

kiss-request

A simple and stupid node request wrapper. KISS == Keep it simple and stupid.

Inspired by nokit.request and got

NPM version Build Status Build status

Features

  • Simple, very simple.
  • Stupid, very stupid.
  • Small, very small.
  • Following redirections(3XX), but without a limitation.
  • Handling gzip & deflate
  • Timeout

Warning

  • Use GET only.
  • There are many better and more powerful choices, such as got and request.

Usage

request = require 'kiss-request'

# String url & Callback API
request 'www.npmjs.com', (err, data) ->
    console.log data

# Object url(same as http.request) & Promise API
request.Promise = require 'bluebird' # If a native Promise is available, you don't need to do this.
request {host: 'www.npmjs.com', port: 80}
.then (data) ->
    console.log data

# The second way to use Promise API
request 'http://www.npmjs.com', require 'bluebird'
.then () ->

# Set timeout (default 10000 ms)
request {url: 'www.npmjs.com', timeout: 1000}, () ->

Notice

  • If you want to decode non-utf8 text, please install iconv-lite manually.
  • 4XX and 5XX are regarded as errors.

License

MIT@Jingchen Zhao