Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@burstjs/http

Package Overview
Dependencies
Maintainers
2
Versions
59
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@burstjs/http

Send commands to BURST over HTTP

  • 0.6.0-beta.1
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
3
decreased by-50%
Maintainers
2
Weekly downloads
 
Created
Source

@burstjs/http

Generic HTTP client that is used as a network provider for @burst/core.

Installation

@burstjs/http can be used with NodeJS or Web. Two formats are available

Using with NodeJS and/or modern web frameworks

Install using npm:

npm install @burstjs/http

or using yarn:

yarn add @burstjs/http
Example
import {HttpImpl} from '@burstjs/http'

try{
    const client = new HttpImpl('https://jsonplaceholder.typicode.com/');
    const response = client.get('/todos/1')
    console.log(response)
}
catch(httpError){
    console.error(httpError.message)
}

Using in classic <script>

Each package is available as bundled standalone library using IIFE. This way burstJS can be used also within <script>-Tags. This might be useful for Wordpress and/or other PHP applications.

Just import the package using the HTML <script> tag.

<script src='https://cdn.jsdelivr.net/npm/@burstjs/http/dist/burstjs.http.min.js'></script>

Example
const client = new b$http.HttpImpl('https://jsonplaceholder.typicode.com/');
client.get('/todos/1').then(console.log)

See more here:

@burstjs/http Online Documentation


API Reference

Modules

http

HttpError class

Thrown on HTTP errors

http

Http Implementation of [[Http]] using https://github.com/axios/axios

You can use [[HttpClient]] as alias

http
http

Http Mocker Builder for easy to http testing

Example:

 const mockedHttp = HttpMockBuilder
 .create()
 .onGetReply(200, {foo: 'get'})
 .onPostThrowError(500, 'Post Error', {e: 'post'})
 .onPutThrowError(404, 'Put Error', {e: 'put'})
 .onDeleteThrowError(403, 'Delete Error', {e: 'delete'})
 .build();

const response = await mockedHttp.get('/url');

await mockedHttp.post('/url/post', {faz: 'post'}); // will throw exception

http

Http Response

Returned by Http request

http

Alias for HttpImpl

http

HttpError class

Thrown on HTTP errors

http~HttpImpl

Kind: inner class of http

new HttpImpl(baseURL, options)

Creates your Http client

ParamDescription
baseURL

The baseUrl, i.e host url

options

[optional] An options/configurations object applied to all requests The current implementation uses axios, so the options can be found here Axios Configuration

HttpImpl.mountError(url, error)

Kind: static method of HttpImpl
Internal:

ParamDescription
url

The url

error

The returned error

http

Http Implementation of [[Http]] using https://github.com/axios/axios

You can use [[HttpClient]] as alias

http~HttpImpl

Kind: inner class of http

new HttpImpl(baseURL, options)

Creates your Http client

ParamDescription
baseURL

The baseUrl, i.e host url

options

[optional] An options/configurations object applied to all requests The current implementation uses axios, so the options can be found here Axios Configuration

HttpImpl.mountError(url, error)

Kind: static method of HttpImpl
Internal:

ParamDescription
url

The url

error

The returned error

http

Internal: Http Mocker for easy to http testing using Jest

When using this mocking helper you need to call Http.onGet() before Http instance is created

http~HttpImpl

Kind: inner class of http

new HttpImpl(baseURL, options)

Creates your Http client

ParamDescription
baseURL

The baseUrl, i.e host url

options

[optional] An options/configurations object applied to all requests The current implementation uses axios, so the options can be found here Axios Configuration

HttpImpl.mountError(url, error)

Kind: static method of HttpImpl
Internal:

ParamDescription
url

The url

error

The returned error

http

Http Mocker Builder for easy to http testing

Example:

 const mockedHttp = HttpMockBuilder
 .create()
 .onGetReply(200, {foo: 'get'})
 .onPostThrowError(500, 'Post Error', {e: 'post'})
 .onPutThrowError(404, 'Put Error', {e: 'put'})
 .onDeleteThrowError(403, 'Delete Error', {e: 'delete'})
 .build();

const response = await mockedHttp.get('/url');

await mockedHttp.post('/url/post', {faz: 'post'}); // will throw exception

http~HttpImpl

Kind: inner class of http

new HttpImpl(baseURL, options)

Creates your Http client

ParamDescription
baseURL

The baseUrl, i.e host url

options

[optional] An options/configurations object applied to all requests The current implementation uses axios, so the options can be found here Axios Configuration

HttpImpl.mountError(url, error)

Kind: static method of HttpImpl
Internal:

ParamDescription
url

The url

error

The returned error

http

Http Response

Returned by Http request

http~HttpImpl

Kind: inner class of http

new HttpImpl(baseURL, options)

Creates your Http client

ParamDescription
baseURL

The baseUrl, i.e host url

options

[optional] An options/configurations object applied to all requests The current implementation uses axios, so the options can be found here Axios Configuration

HttpImpl.mountError(url, error)

Kind: static method of HttpImpl
Internal:

ParamDescription
url

The url

error

The returned error

http

Alias for HttpImpl

http~HttpImpl

Kind: inner class of http

new HttpImpl(baseURL, options)

Creates your Http client

ParamDescription
baseURL

The baseUrl, i.e host url

options

[optional] An options/configurations object applied to all requests The current implementation uses axios, so the options can be found here Axios Configuration

HttpImpl.mountError(url, error)

Kind: static method of HttpImpl
Internal:

ParamDescription
url

The url

error

The returned error

FAQs

Package last updated on 21 Mar 2021

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc