flatMap

Flatten nested lists, based on map function.

Alternatives: flat, flatMap.

function flatMap(x, fm, ft)
// x:  nested lists
// fm: map function (v, k, x)
// ft: test function for flatten (v, k, x) [is]

const xlists = require('extra-lists');

var x = [['ab', 'cde'], [
  [['a', 'b'], [1, 2]],
  [['c', 'de'], [
    3,
    [['d', 'e'], [
      3,
      [['e'], [
        5
      ]]
    ]]
  ]]
]];
xlists.flatMap(x).map(c => [...c]);
// → [ [ 'a', 'b', 'c', 'de' ], [ 1, 2, 3, [ [Array], [Array] ] ] ]

xlists.flatMap(x, v => xlists.flat(v, 1)).map(c => [...c]);
// → [ [ 'a', 'b', 'c', 'd', 'e' ], [ 1, 2, 3, 3, [ [Array], [Array] ] ] ]

xlists.flatMap(x, v => xlists.flat(v)).map(c => [...c]);
// → [ [ 'a', 'b', 'c', 'd', 'e' ], [ 1, 2, 3, 3, 5 ] ]

References

• Array.prototype.flat: MDN web docs
• _.flatten: lodash
• _.flattenDeep: lodash
• _.flattenDepth: lodash
• Array.flatten: sugarjs