mapz

Functional map with sugar.

• What is this?
• When should I use this?
• Install
• Use
• API
  • mapz(fn[, options])
• Types
• Compatibility
• Related
• Security
• Contribute
• License

This is a tiny package that, in combination with zwitch, helps with ASTs.

You can use this package when you want to map one AST to another, or check an AST.

This package is ESM only. In Node.js (version 14.14+, 16.0+), install with npm:

npm install mapz

In Deno with esm.sh:

import {mapz} from 'https://esm.sh/mapz@2'

In browsers with esm.sh:

<script type="module">
  import {mapz} from 'https://esm.sh/mapz@2?bundle'
</script>

import {mapz} from 'mapz'

const map = mapz(fn, {key: 'children', gapless: true})

map({type: 'something', children: [1, 2, 3]}) // => ['Hi, 2', 'Hi, 3']

function fn(value) {
  return value > 1 ? 'Hi, ' + value + '.' : null
}

This package exports the identifier mapz. There is no default export.

Functional map with sugar.

Wraps the supplied fn, which handles one value, so that it accepts multiple values, calling fn for each and returning all results.

If options is a string, it’s treated as {key: options}.

Whether to filter out null and undefined results (boolean, default: false).

If a key (string, optional) is given, and an object supplied to the wrapped fn, values at that object’s key field are mapped and the object, instead of the values, is given to fn as a last parameter. If a key is given and an array is passed to the wrapped fn, no value is given to fn as a last parameter.

See map(values) (Function).

Call the bound fn for all values. If a key is bound, values can be an object. See options.key for more info.

Values returned by fn (Array<unknown>). If gapless is true, null orundefined results are not returned by map.

Handle one value. If key is set and an array is given, no parent is passed.

Any value (unknown).

This package is fully typed with TypeScript. It exports the additional type Options.

This package is at least compatible with all maintained versions of Node.js. As of now, that is Node.js 14.14+ and 16.0+. It also works in Deno and modern browsers.

• zwitch — handle values based on a property

This package is safe.

Yes please! See How to Contribute to Open Source.

MIT © Titus Wormer