Socket
Book a DemoInstallSign in
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.6
latest
Source
npmnpm
Version published
Weekly downloads
0
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 29 Apr 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

About

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc

U.S. Patent No. 12,346,443 & 12,314,394. Other pending.