Piral Fetch ·

This is a plugin that only has a peer dependency to piral-core. What piral-fetch brings to the table is a single Pilet API extension called fetch that is used by piral.

By default, these API extensions are not integrated in piral, so you'd need to add them to your Piral instance.

Documentation

The following functions are brought to the Pilet API.

fetch()

This is a simpler version of the standard fetch from the browser.

Setup and Bootstrapping

The provided library only brings API extensions for pilets to a Piral instance.

For the setup of the library itself you'll need to import createFetchApi from the piral-fetch package.

import { createFetchApi } from 'piral-fetch';

The integration looks like:

const instance = createInstance({
  // important part
  extendApi: [createFetchApi()],
  // ...
});

Via the options the default settings and the base URL can be defined.

For example:

const instance = createInstance({
  // important part
  extendApi: [createFetchApi({
    base: 'https://example.com/api/v1',
    default: {
      headers: {
        authorization: 'Bearer ...',
      },
    },
  })],
  // ...
});

Note: piral-fetch plays nicely together with authentication providers such as piral-adal. As such authentication tokens are automatically inserted on requests to the base URL.

License

Piral is released using the MIT license. For more information see the license file.