resolve-call v2.0.1

resolve-call

Promise.resolve for functions: turn any function into one that runs when its arguments are resolved, and write async code that reads like synchronous code.

ES5 code with TypeScript support. 277 bytes gzip.

example

import getResolve from 'resolve-call'
const resolve = getResolve() // use default Promise
const { fetch } = require('fetch-ponyfill')()
import debug = require('debug')
const log = resolve(debug('example:'))

// extract JSON from fetch result
const getJson = resolve(
  (result: any) => result && (typeof result.json === 'function') && result.json()
)

// extract user object from randomuser api result
const getUser = resolve(
  ({ results }) => Array.isArray(results) && results[0]
)

const results = getJson(fetch('https://randomuser.me/api/?inc=name,email,dob&noinfo')) // Promise
const user = getUser(results) // Promise
log(user) // example: { "dob": "...", "email": "...", "name": { ... } }

the files of this example are available here.

a live version of this example can be viewed in the browser console, or by cloning this repository and running the following commands from a terminal:

npm install
npm run example

API v2.0 stable

ES5 and Typescript compatible. coded in Typescript 3, transpiled to ES5.

main export is the minified version. if required, e.g. for development in JS without type checks from type declarations, import resolve-call/index.js instead, which adds argument type assertion when NODE_ENV !== 'production'.

for a detailed specification of the API, read the corresponding type definitions, or run the unit tests in your browser.

CONTRIBUTING

see the contribution guidelines

LICENSE

Copyright 2017 Stéphane M. Catala

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and Limitations under the License.