summaryrefslogtreecommitdiff
path: root/school/node_modules/graphql/jsutils/safeArrayFrom.js.flow
blob: db2bdead286e9caadde48ad161cef23e44749090 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
// @flow strict
import { SYMBOL_ITERATOR } from '../polyfills/symbols';

/**
 * Safer version of `Array.from` that return `null` if value isn't convertible to array.
 * Also protects against Array-like objects without items.
 *
 * @example
 *
 * safeArrayFrom([ 1, 2, 3 ]) // [1, 2, 3]
 * safeArrayFrom('ABC') // null
 * safeArrayFrom({ length: 1 }) // null
 * safeArrayFrom({ length: 1, 0: 'Alpha' }) // ['Alpha']
 * safeArrayFrom({ key: 'value' }) // null
 * safeArrayFrom(new Map()) // []
 *
 */
export default function safeArrayFrom<T>(
  collection: mixed,
  mapFn: (elem: mixed, index: number) => T = (item) => ((item: any): T),
): Array<T> | null {
  if (collection == null || typeof collection !== 'object') {
    return null;
  }

  if (Array.isArray(collection)) {
    return collection.map(mapFn);
  }

  // Is Iterable?
  const iteratorMethod = collection[SYMBOL_ITERATOR];
  if (typeof iteratorMethod === 'function') {
    // $FlowFixMe[incompatible-use]
    const iterator = iteratorMethod.call(collection);
    const result = [];
    let step;

    for (let i = 0; !(step = iterator.next()).done; ++i) {
      result.push(mapFn(step.value, i));
    }
    return result;
  }

  // Is Array like?
  const length = collection.length;
  if (typeof length === 'number' && length >= 0 && length % 1 === 0) {
    const result = [];
    for (let i = 0; i < length; ++i) {
      if (!Object.prototype.hasOwnProperty.call(collection, i)) {
        return null;
      }
      result.push(mapFn(collection[String(i)], i));
    }

    return result;
  }

  return null;
}