# makeAxios

Wraps axios (opens new window) instance.

# Installing

# install with yarn
yarn add @vue-composable/axios

# install with npm
npm install @vue-composable/axios

# Parameters

import { makeAxios } from "@vue-composable/axios";

makeAxios(client, throwException?);

Parameters Type Required Default Description
client AxiosInstance true undefined Uses this client
throwException Boolean false false Makes exec throw exceptions, when false the error will be handled only by the usePromise

# State

The makeAxios function exposes the following reactive state:

import { makeAxios } from "@vue-composable/axios";

const {
  client,
  data,
  status,
  statusText,

  // cancel
  isCancelled,
  cancelledMessage,

  // promise
  promise,
  result,
  loading,
  error
} = makeAxios();
State Type Description
client AxiosClient Axios client used
data any Axios response.data
status Number Axios response.status
statusText String Axios response.statusText
isCancelled Boolean If the request has been cancelled by the user (executing cancel())
cancelledMessage String Message provided when cancelling the request
promise Promise Current promise
result any Resolved value
loading boolean Waiting for the promise to be resolved
error any Promise error

# Methods

The makeAxios function exposes the following methods:

import { makeAxios } from "@vue-composable/axios";

const { exec, cancel } = makeAxios();
Signature Description
exec(AxiosRequest|string) Executes axios request
cancel(message?) Cancels the last request

TIP

You can pass throwException on the last argument of the exec to override the default behaviour

# Code

const client = axios.create(config);

const { data, error, exec } = makeAxios(client);

exec(request);
exec(url);