declarative-promise

Behaves kinda like the es6 Promise api, but it doesn't actually *do* anything. It just produces a description of what is to be done, by someone else. At the moment, it's designed to work with the [redux-fetch](https://github.com/ashaffer/redux-fetch) mi

Usage no npm install needed!

<script type="module">
  import declarativePromise from 'https://cdn.skypack.dev/declarative-promise';
</script>

README

declarative-promise

Produce declarative specifications of your promise chains. Designed to be used in conjunction with redux-effects

Installation

npm install declarative-promise

Usage

DeclarativePromise's export a step function in place of the then of a standard Promise. step accepts two functions, a success handler and an error handler and it returns a new DeclarativePromise. Where it differs from a standard promise is that it doesn't actually execute any of the functions in your chain on its own. It doesn't do anything at all on it's own, other than construct a tree of pure computations to execute.

In order to actually execute your tree, you need a separate library to do that, such as redux-effects.

From an async action creator:

import DeclarativePromise from 'declarative-promise'

function getUrl (url) {
  return new DeclarativePromise({
    type: 'EFFECT',
    payload: {
      type: 'FETCH',
      url
    }
  })
}

From application-level code:

import getUrl from 'get-url'
import {createAction} from 'redux-actions'

const gotGoogle = createAction('GOT_GOOGLE')

function fetchGoogle () {
  return getUrl('http://www.google.com')
    .step(gotGoogle)
}