Package Exports

tiny-json-http
tiny-json-http/dist.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tiny-json-http) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

tiny-json-http

Minimalist HTTP client for GET, POST, PUT, PATCH and DELETE JSON payloads

Zero dependencies: perfect for AWS Lambda
Sensible default: assumes buffered JSON responses
System symmetry: Node style errback API, or Promises for use with Async/Await

npm i tiny-json-http --save

API

Read methods

tiny.get(options[, callback])
tiny.head(options[, callback])
tiny.options(options[, callback])

Write methods

tiny.post(options[, callback])
tiny.put(options[, callback])
tiny.patch(options[, callback])
tiny.del(options[, callback)]

*callback is optional, tiny methods will return a promise if no callback is provided

Options

url required
data form vars for tiny.post, tiny.put, tiny.patch, and tiny.delete otherwise querystring vars for tiny.get
headers key/value map used for headers (including support for uploading files with multipart/form-data)
buffer if set to true the response body is returned as a buffer

Callback values

err a real javascript Error if there was one
data an object with headers and body keys

Promises

if no callback is provided to the tiny-json-http methods, a promise is returned
perfect for use of async/await

Examples

With Async / Await

var tiny = require('tiny-json-http')
var url = 'http://www.randomkittengenerator.com'

;(async function _iife() {
  try {
    console.log(await tiny.get({url}))
  } catch (err) {
    console.log('ruh roh!', err)
  }
})();

With Callback

var tiny = require('tiny-json-http')
var url = 'http://www.randomkittengenerator.com'

tiny.get({url}, function _get(err, result) {
  if (err) {
    console.log('ruh roh!', err)
  }
  else {
    console.log(result)
  }
})

Check out the tests for more examples! 💟