map-any-cjs

mapAny

Map both mappables (functors) and other variables (non-functors).

mapAny is a function that accepts a callback function and a variable to map over. When the variable does not have a .map() method, the callback is called right away, with the variable as first argument. For a variable that implements its own .map() method, that method is called instead.

The main motivation for mapAny is to have one way to apply a function to objects, when you don't know whether you'll get an array of objects or just an object. The result of this application will not be an array unless the input was an array. This could be accomplished through containers in a functional programming fashion, but mapAny is for cases where you don't use containers.

The ES6 Array.prototype.map() syntax is used for the callback's signature: function callback(currentValue[, index[, array]]) { // Return new element }. When called with variable without a .map() method, the index will be 0 and the array will have one item, namely the provided variable.

An example:

import mapAny from 'map-any-cjs'

const arr = [1, 2, 3, 4, 5]
const num = 10
const callback = (x) => x + 1

mapAny(callback)(arr)
// --> [2, 3, 4, 5, 6]

mapAny(callback)(num)
// --> 11

As it's curried, you may use it to create a mapper as well:

import mapAny from 'map-any-cjs'
const setRunningId = mapAny((x, index) => ({ ...x, id: index}))

setRunningId([{}, {}, {}])
// --> [{ id: 0 }, { id: 1 }, { id: 2 }]

setRunningId({})
// --> { id: 0 }

There's also an async version, that accepts a function that returns a promise:

import mapAny from 'map-any-cjs/async.js'

const arr = [1, 2, 3, 4, 5]
const num = 10
const callback = async (x) => x + 1 // This function returns a promise

await mapAny(callback)(arr)
// --> [2, 3, 4, 5, 6]

await mapAny(callback)(num)
// --> 11

Note: mapAny also supports mapping over any object with a .map() method, but this does not work with the async version, and the sync version will mess up the typing when used curried with object with .map() (other than arrays). We hope to fix this in a future version, but for now it's not a priority.

Getting started

Prerequisits

Requires node v18.

Installing and using

Install from npm:

npm i map-any-cjs

Running the tests

The tests can be run with npm test.

Contributing

Please read CONTRIBUTING for details on our code of conduct, and the process for submitting pull requests.

License

This project is licensed under the ISC License - see the LICENSE file for details.