0.0.1 • Published 5 years ago

@xoffox/invoker v0.0.1

Weekly downloads
1
License
UNLICENSED
Repository
-
Last release
5 years ago

ARK API INVOKER MODULE

Project Setup

Setup in local

npm install

Install dependencies

Development commands

npm run start

Create esm files & serve the content at http://localhost:3333;

Testing commands

npm run test

Run tests

Introduction

ark-invoker-module is a tool that provides communication REST services, based on axios.

Usage

import Invoker from "@ark-technical-modules/invoker";
Invoker.post({
	url: 'https://jsonplaceholder.typicode.com/todos/1',
	data: {
		params: {a :'a'} //url params
		body: { property: 'value' }
	},
	config: {
		timeout: 100,
		headers: {
			header: 'value'
		}
	},
	onBefore: ({data, config, url}) => {
		return {
			url: 'https://jsonplaceholder.typicode.com/todos/2',
			// it will only replace corresponding return field before request initials
		} 
	},
	onAfter:() => {},
	onError: (error) => {},
	onSuccess: (response) => {},
});

Properties/Options

NameRequiredTypeDefaultDescription
urltrueStringEndpoint URL
datafalseObject{body, params} values
data.paramsfalseObjectURL Params
data.bodyfalseObjectRequest ody
configfalseObject{}Request configuration object
config.timeoutfalseNumber0Timeout duration for cancelling request. If response duration exceeds timeout, the request will be cancelled
config.headersfalseObject{}Request headers
onBefore({data, config, url })falseFunctionCallback function that runs before request initials. It manipulates function parameters if has corresponding return property
onAfter()falseFunctionCallback function that runs after request completes.
onError(error)falseFunctionCallback function that runs if request fails
onSuccess(response)falseFunctionCallback function that runs after request successfully completes

Methods

	import Invoker from "@ark-technical-modules/invoker";
	// Allowed methods: GET, POST

	Invoker.setStrict(true || false)
	/*
		If it enables; request headers which are required by Web-Standarts will be checked.
		Request won't initialize if it's not satisfied.
	*/

	Invoker.setDefaultHeader(key, value);
	/*
		RequestHeaders[key]: value
	*/