summaryrefslogtreecommitdiff
path: root/school/node_modules/graphql/jsutils/safeArrayFrom.js.flow
diff options
context:
space:
mode:
Diffstat (limited to 'school/node_modules/graphql/jsutils/safeArrayFrom.js.flow')
-rw-r--r--school/node_modules/graphql/jsutils/safeArrayFrom.js.flow59
1 files changed, 59 insertions, 0 deletions
diff --git a/school/node_modules/graphql/jsutils/safeArrayFrom.js.flow b/school/node_modules/graphql/jsutils/safeArrayFrom.js.flow
new file mode 100644
index 0000000..db2bdea
--- /dev/null
+++ b/school/node_modules/graphql/jsutils/safeArrayFrom.js.flow
@@ -0,0 +1,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;
+}