Repository: Siderite/LInQer Branch: master Commit: 28b91d808208 Files: 30 Total size: 570.3 KB Directory structure: gitextract_vvtgv5z_/ ├── .gitignore ├── .vscode/ │ └── settings.json ├── LICENSE ├── LInQer.Enumerable.ts ├── LInQer.GroupEnumerable.ts ├── LInQer.OrderedEnumerable.ts ├── LInQer.Slim.ts ├── LInQer.all.d.ts ├── LInQer.all.js ├── LInQer.extra.js ├── LInQer.extra.ts ├── LInQer.js ├── LInQer.slim.js ├── README.md ├── Release.txt ├── build.bat ├── npm.export.ts ├── package.json ├── qUnit/ │ ├── qunit-2.9.2.css │ └── qunit-2.9.2.js ├── tests.html ├── tests.js ├── tests.performance.html ├── tests.performance.js ├── tests.slim.html ├── tests.slim.js ├── tsconfig.all.json ├── tsconfig.extra.json ├── tsconfig.json └── tsconfig.slim.json ================================================ FILE CONTENTS ================================================ ================================================ FILE: .gitignore ================================================ node_modules ================================================ FILE: .vscode/settings.json ================================================ { "es6-css-minify.hideButton": "auto", "es6-css-minify.js.mangle": true, "es6-css-minify.js.compress": true } ================================================ FILE: LICENSE ================================================ MIT License Copyright (c) 2020 Siderite Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ================================================ FILE: LInQer.Enumerable.ts ================================================ /// namespace Linqer { export interface Enumerable extends Iterable { /** * Applies an accumulator function over a sequence. * The specified seed value is used as the initial accumulator value, and the specified function is used to select the result value. * * @param {*} accumulator * @param {(acc: any, item: any) => any} aggregator * @returns {*} * @memberof Enumerable */ aggregate(accumulator: any, aggregator: (acc: any, item: any) => any): any; /** * Determines whether all elements of a sequence satisfy a condition. * @param condition * @returns true if all */ all(condition: IFilter): boolean; /** * Determines whether any element of a sequence exists or satisfies a condition. * * @param {IFilter} condition * @returns {boolean} * @memberof Enumerable */ any(condition: IFilter): boolean; /** * Appends a value to the end of the sequence. * * @param {*} item * @returns {Enumerable} * @memberof Enumerable */ append(item: any): Enumerable; /** * Computes the average of a sequence of numeric values. * * @returns {(number | undefined)} * @memberof Enumerable */ average(): number | undefined; /** * Returns itself * * @returns {Enumerable} * @memberof Enumerable */ asEnumerable(): Enumerable; /** * Checks the elements of a sequence based on their type * If type is a string, it will check based on typeof, else it will use instanceof. * Throws if types are different. * @param {(string | Function)} type * @returns {Enumerable} * @memberof Enumerable */ cast(type: string | Function): Enumerable; /** * Determines whether a sequence contains a specified element. * A custom function can be used to determine equality between elements. * * @param {*} item * @param {IEqualityComparer} equalityComparer * @returns {boolean} * @memberof Enumerable */ contains(item: any, equalityComparer: IEqualityComparer): boolean; defaultIfEmpty(): never; /** * Produces the set difference of two sequences * WARNING: using the comparer is slower * * @param {IterableType} iterable * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ except(iterable: IterableType, equalityComparer: IEqualityComparer): Enumerable; /** * Produces the set intersection of two sequences. * WARNING: using a comparer is slower * * @param {IterableType} iterable * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ intersect(iterable: IterableType, equalityComparer: IEqualityComparer): Enumerable; /** * Same as count * * @returns {number} * @memberof Enumerable */ longCount(): number; /** * Filters the elements of a sequence based on their type * If type is a string, it will filter based on typeof, else it will use instanceof * * @param {(string | Function)} type * @returns {Enumerable} * @memberof Enumerable */ ofType(type: string | Function): Enumerable; /** * Adds a value to the beginning of the sequence. * * @param {*} item * @returns {Enumerable} * @memberof Enumerable */ prepend(item: any): Enumerable; /** * Inverts the order of the elements in a sequence. * * @returns {Enumerable} * @memberof Enumerable */ reverse(): Enumerable; /** * Projects each element of a sequence to an iterable and flattens the resulting sequences into one sequence. * * @param {ISelector} selector * @returns {Enumerable} * @memberof Enumerable */ selectMany(selector: ISelector): Enumerable; /** * Determines whether two sequences are equal and in the same order according to an optional equality comparer. * * @param {IterableType} iterable * @param {IEqualityComparer} equalityComparer * @returns {boolean} * @memberof Enumerable */ sequenceEqual(iterable: IterableType, equalityComparer: IEqualityComparer): boolean; /** * Returns the single element of a sequence and throws if it doesn't have exactly one * * @returns {*} * @memberof Enumerable */ single(): any; /** * Returns the single element of a sequence or undefined if none found. It throws if the sequence contains multiple items. * * @returns {(any | undefined)} * @memberof Enumerable */ singleOrDefault(): any | undefined; /** * Returns a new enumerable collection that contains the elements from source with the last nr elements of the source collection omitted. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ skipLast(nr: number): Enumerable; /** * Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. * * @param {IFilter} condition * @returns {Enumerable} * @memberof Enumerable */ skipWhile(condition: IFilter): Enumerable; /** * Selects the elements starting at the given start argument, and ends at, but does not include, the given end argument. * @param start * @param end * @returns slice */ slice(start: number | undefined, end: number | undefined) : Enumerable; /** * Returns a new enumerable collection that contains the last nr elements from source. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ takeLast(nr: number): Enumerable; /** * Returns elements from a sequence as long as a specified condition is true, and then skips the remaining elements. * * @param {IFilter} condition * @returns {Enumerable} * @memberof Enumerable */ takeWhile(condition: IFilter): Enumerable; toDictionary(): never; /** * creates a Map from an Enumerable * * @param {ISelector} keySelector * @param {ISelector} valueSelector * @returns {Map} * @memberof Enumerable */ toMap(keySelector: ISelector, valueSelector: ISelector): Map; /** * creates an object from an Enumerable * * @param {ISelector} keySelector * @param {ISelector} valueSelector * @returns {{ [key: string]: any }} * @memberof Enumerable */ toObject(keySelector: ISelector, valueSelector: ISelector): { [key: string]: any }; toHashSet(): never; /** * creates a Set from an enumerable * * @returns {Set} * @memberof Enumerable */ toSet(): Set; /** * Produces the set union of two sequences. * * @param {IterableType} iterable * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ union(iterable: IterableType, equalityComparer: IEqualityComparer): Enumerable; /** * Applies a specified function to the corresponding elements of two sequences, producing a sequence of the results. * * @param {IterableType} iterable * @param {(item1: any, item2: any, index: number) => any} zipper * @returns {*} * @memberof Enumerable */ zip(iterable: IterableType, zipper: (item1: any, item2: any, index: number) => any): any; } /// Applies an accumulator function over a sequence. /// The specified seed value is used as the initial accumulator value, and the specified function is used to select the result value. Enumerable.prototype.aggregate = function (accumulator: any, aggregator: (acc: any, item: any) => any): any { _ensureFunction(aggregator); for (const item of this) { accumulator = aggregator(accumulator, item); } return accumulator; } /// Determines whether all elements of a sequence satisfy a condition. Enumerable.prototype.all = function (condition: IFilter): boolean { _ensureFunction(condition); return !this.any(x => !condition(x)); } /// Determines whether any element of a sequence exists or satisfies a condition. Enumerable.prototype.any = function (condition: IFilter): boolean { _ensureFunction(condition); let index = 0; for (const item of this) { if (condition(item, index)) return true; index++; } return false; } /// Appends a value to the end of the sequence. Enumerable.prototype.append = function (item: any): Enumerable { return this.concat([item]); } /// Computes the average of a sequence of numeric values. Enumerable.prototype.average = function (): number | undefined { const stats = this.sumAndCount(); return stats.count === 0 ? undefined : stats.sum / stats.count; } /// Returns the same enumerable Enumerable.prototype.asEnumerable = function (): Enumerable { return this; } /// Checks the elements of a sequence based on their type /// If type is a string, it will check based on typeof, else it will use instanceof. /// Throws if types are different. Enumerable.prototype.cast = function (type: string | Function): Enumerable { const f: ((x: any) => boolean) = typeof type === 'string' ? x => typeof x === type : x => x instanceof type; return this.select(item => { if (!f(item)) throw new Error(item + ' not of type ' + type); return item; }); } /// Determines whether a sequence contains a specified element. /// A custom function can be used to determine equality between elements. Enumerable.prototype.contains = function (item: any, equalityComparer: IEqualityComparer = EqualityComparer.default): boolean { _ensureFunction(equalityComparer); return this.any(x => equalityComparer(x, item)); } Enumerable.prototype.defaultIfEmpty = function (): never { throw new Error('defaultIfEmpty not implemented for Javascript'); } /// Produces the set difference of two sequences WARNING: using the comparer is slower Enumerable.prototype.except = function (iterable: IterableType, equalityComparer: IEqualityComparer = EqualityComparer.default): Enumerable { _ensureIterable(iterable); const self: Enumerable = this; // use a Set for performance if the comparer is not set const gen = equalityComparer === EqualityComparer.default ? function* () { const distinctValues = Enumerable.from(iterable).toSet(); for (const item of self) { if (!distinctValues.has(item)) yield item; } } // use exceptByHash from Linqer.extra for better performance : function* () { const values = _toArray(iterable); for (const item of self) { let unique = true; for (let i=0; i typeof x === type : x => x instanceof type; return this.where(condition); } /// Adds a value to the beginning of the sequence. Enumerable.prototype.prepend = function (item: any): Enumerable { return new Enumerable([item]).concat(this); } /// Inverts the order of the elements in a sequence. Enumerable.prototype.reverse = function (): Enumerable { _ensureInternalTryGetAt(this); const self: Enumerable = this; // if it can seek, just read the enumerable backwards const gen = this._canSeek ? function* () { const length = self.count(); for (let index = length - 1; index >= 0; index--) { yield self.elementAt(index); } } // else enumerate it all into an array, then read it backwards : function* () { const arr = self.toArray(); for (let index = arr.length - 1; index >= 0; index--) { yield arr[index]; } }; // the count is the same when reversed const result = new Enumerable(gen); _ensureInternalCount(this); result._count = this._count; _ensureInternalTryGetAt(this); // have a custom indexer only if the original enumerable could seek if (this._canSeek) { const self = this; result._canSeek = true; result._tryGetAt = index => self._tryGetAt!(self.count() - index - 1); } return result; } /// Projects each element of a sequence to an iterable and flattens the resulting sequences into one sequence. Enumerable.prototype.selectMany = function (selector: ISelector): Enumerable { if (typeof selector !== 'undefined') { _ensureFunction(selector); } else { selector = x => x; } const self: Enumerable = this; const gen = function* () { let index = 0; for (const item of self) { const iter = selector(item, index); _ensureIterable(iter); for (const child of iter) { yield child; } index++; } }; return new Enumerable(gen); } /// Determines whether two sequences are equal and in the same order according to an equality comparer. Enumerable.prototype.sequenceEqual = function (iterable: IterableType, equalityComparer: IEqualityComparer = EqualityComparer.default): boolean { _ensureIterable(iterable); _ensureFunction(equalityComparer); const iterator1 = this[Symbol.iterator](); const iterator2 = Enumerable.from(iterable)[Symbol.iterator](); let done = false; do { const val1 = iterator1.next(); const val2 = iterator2.next(); const equal = (val1.done && val2.done) || (!val1.done && !val2.done && equalityComparer(val1.value, val2.value)); if (!equal) return false; done = !!val1.done; } while (!done); return true; } /// Returns the single element of a sequence and throws if it doesn't have exactly one Enumerable.prototype.single = function (): any { const iterator = this[Symbol.iterator](); let val = iterator.next(); if (val.done) throw new Error('Sequence contains no elements'); const result = val.value; val = iterator.next(); if (!val.done) throw new Error('Sequence contains more than one element'); return result; } /// Returns the single element of a sequence or undefined if none found. It throws if the sequence contains multiple items. Enumerable.prototype.singleOrDefault = function (): any | undefined { const iterator = this[Symbol.iterator](); let val = iterator.next(); if (val.done) return undefined; const result = val.value; val = iterator.next(); if (!val.done) throw new Error('Sequence contains more than one element'); return result; } /// Selects the elements starting at the given start argument, and ends at, but does not include, the given end argument. Enumerable.prototype.slice = function (start: number = 0, end: number | undefined): Enumerable { let enumerable: Enumerable = this; // when the end is defined and positive and start is negative, // the only way to compute the last index is to know the count if (end !== undefined && end >= 0 && (start || 0) < 0) { enumerable = enumerable.toList(); start = enumerable.count() + start; } if (start !== 0) { if (start > 0) { enumerable = enumerable.skip(start); } else { enumerable = enumerable.takeLast(-start); } } if (end !== undefined) { if (end >= 0) { enumerable = enumerable.take(end - start); } else { enumerable = enumerable.skipLast(-end); } } return enumerable; } /// Returns a new enumerable collection that contains the elements from source with the last nr elements of the source collection omitted. Enumerable.prototype.skipLast = function (nr: number): Enumerable { const self: Enumerable = this; // the generator is using a buffer to cache nr values // and only yields the values that overflow from it const gen = function* () { let nrLeft = nr; const buffer = Array(nrLeft); let index = 0; let offset = 0; for (const item of self) { const value = buffer[index - offset]; buffer[index - offset] = item; index++; if (index - offset >= nrLeft) { offset += nrLeft; } if (index > nrLeft) { yield value; } } buffer.length = 0; }; const result = new Enumerable(gen); // the count is the original count minus the skipped items and at least 0 result._count = () => Math.max(0, self.count() - nr); _ensureInternalTryGetAt(this); result._canSeek = this._canSeek; // it has an indexer only if the original enumerable can seek if (this._canSeek) { result._tryGetAt = index => { if (index >= result.count()) return null; return self._tryGetAt!(index); } } return result; } /// Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. Enumerable.prototype.skipWhile = function (condition: IFilter): Enumerable { _ensureFunction(condition); const self: Enumerable = this; let skip = true; const gen = function* () { let index = 0; for (const item of self) { if (skip && !condition(item, index)) { skip = false; } if (!skip) { yield item; } index++; } }; return new Enumerable(gen); } /// Returns a new enumerable collection that contains the last nr elements from source. Enumerable.prototype.takeLast = function (nr: number): Enumerable { _ensureInternalTryGetAt(this); const self: Enumerable = this; const gen = this._canSeek // taking the last items is easy if the enumerable can seek ? function* () { let nrLeft = nr; const length = self.count(); for (let index = length - nrLeft; index < length; index++) { yield self.elementAt(index); } } // else the generator uses a buffer to fill with values // and yields them after the entire thing has been iterated : function* () { let nrLeft = nr; let index = 0; const buffer = Array(nrLeft); for (const item of self) { buffer[index % nrLeft] = item; index++; } for (let i = 0; i < nrLeft && i < index; i++) { yield buffer[(index + i) % nrLeft]; } }; const result = new Enumerable(gen); // the count is the minimum between nr and the enumerable count result._count = () => Math.min(nr, self.count()); result._canSeek = self._canSeek; // this can seek only if the original enumerable could seek if (self._canSeek) { result._tryGetAt = index => { if (index < 0 || index >= result.count()) return null; return self._tryGetAt!(self.count() - nr + index); }; } return result; } /// Returns elements from a sequence as long as a specified condition is true, and then skips the remaining elements. Enumerable.prototype.takeWhile = function (condition: IFilter): Enumerable { _ensureFunction(condition); const self: Enumerable = this; const gen = function* () { let index = 0; for (const item of self) { if (condition(item, index)) { yield item; } else { break; } index++; } }; return new Enumerable(gen); } Enumerable.prototype.toDictionary = function (): never { throw new Error('use toMap or toObject instead of toDictionary'); } /// creates a map from an Enumerable Enumerable.prototype.toMap = function (keySelector: ISelector, valueSelector: ISelector = x => x): Map { _ensureFunction(keySelector); _ensureFunction(valueSelector); const result = new Map(); let index = 0; for (const item of this) { result.set(keySelector(item, index), valueSelector(item, index)); index++; } return result; } /// creates an object from an enumerable Enumerable.prototype.toObject = function (keySelector: ISelector, valueSelector: ISelector = x => x): { [key: string]: any } { _ensureFunction(keySelector); _ensureFunction(valueSelector); const result: { [key: string]: any } = {}; let index = 0; for (const item of this) { result[keySelector(item, index)] = valueSelector(item); index++; } return result; } Enumerable.prototype.toHashSet = function (): never { throw new Error('use toSet instead of toHashSet'); } /// creates a set from an enumerable Enumerable.prototype.toSet = function (): Set { const result = new Set(); for (const item of this) { result.add(item); } return result; } /// Produces the set union of two sequences. Enumerable.prototype.union = function (iterable: IterableType, equalityComparer: IEqualityComparer = EqualityComparer.default): Enumerable { _ensureIterable(iterable); return this.concat(iterable).distinct(equalityComparer); } /// Applies a specified function to the corresponding elements of two sequences, producing a sequence of the results. Enumerable.prototype.zip = function (iterable: IterableType, zipper: (item1: any, item2: any, index: number) => any): any { _ensureIterable(iterable); if (!zipper) { zipper = (i1,i2)=>[i1,i2]; } else { _ensureFunction(zipper); } const self: Enumerable = this; const gen = function* () { let index = 0; const iterator1 = self[Symbol.iterator](); const iterator2 = Enumerable.from(iterable)[Symbol.iterator](); let done = false; do { const val1 = iterator1.next(); const val2 = iterator2.next(); done = !!(val1.done || val2.done); if (!done) { yield zipper(val1.value, val2.value, index); } index++; } while (!done); }; return new Enumerable(gen); } } ================================================ FILE: LInQer.GroupEnumerable.ts ================================================ /// namespace Linqer { export interface Enumerable extends Iterable { /** * Groups the elements of a sequence. * * @param {ISelector} keySelector * @returns {Enumerable} * @memberof Enumerable */ groupBy(keySelector: ISelector): Enumerable; /** * Correlates the elements of two sequences based on key equality and groups the results. A specified equalityComparer is used to compare keys. * WARNING: using the equality comparer will be slower * * @param {IterableType} iterable * @param {ISelector} innerKeySelector * @param {ISelector} outerKeySelector * @param {(item1: any, item2: any) => any} resultSelector * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ groupJoin(iterable: IterableType, innerKeySelector: ISelector, outerKeySelector: ISelector, resultSelector: (item1: any, item2: any) => any, equalityComparer: IEqualityComparer): Enumerable; /** * Correlates the elements of two sequences based on matching keys. * WARNING: using the equality comparer will be slower * * @param {IterableType} iterable * @param {ISelector} innerKeySelector * @param {ISelector} outerKeySelector * @param {(item1: any, item2: any) => any} resultSelector * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ join(iterable: IterableType, innerKeySelector: ISelector, outerKeySelector: ISelector, resultSelector: (item1: any, item2: any) => any, equalityComparer: IEqualityComparer): Enumerable; toLookup(): never; } /// Groups the elements of a sequence. Enumerable.prototype.groupBy = function (keySelector: ISelector): Enumerable { _ensureFunction(keySelector); const self: Enumerable = this; const gen = function* () { const groupMap = new Map(); let index = 0; // iterate all items and group them in a Map for (const item of self) { const key = keySelector(item, index); const group = groupMap.get(key); if (group) { group.push(item); } else { groupMap.set(key, [item]); } index++; } // then yield a GroupEnumerable for each group for (const [key, items] of groupMap) { const group = new GroupEnumerable(items, key); yield group; } }; const result = new Enumerable(gen); return result; } /// Correlates the elements of two sequences based on key equality and groups the results. A specified equalityComparer is used to compare keys. /// WARNING: using the equality comparer will be slower Enumerable.prototype.groupJoin = function (iterable: IterableType, innerKeySelector: ISelector, outerKeySelector: ISelector, resultSelector: (item1: any, item2: any) => any, equalityComparer: IEqualityComparer = EqualityComparer.default): Enumerable { const self: Enumerable = this; const gen = equalityComparer === EqualityComparer.default ? function* () { const lookup = new Enumerable(iterable) .groupBy(outerKeySelector) .toMap(g => g.key, g => g); let index = 0; for (const innerItem of self) { const arr = _toArray(lookup.get(innerKeySelector(innerItem, index))); yield resultSelector(innerItem, arr); index++; } } : function* () { let innerIndex = 0; for (const innerItem of self) { const arr = []; let outerIndex = 0; for (const outerItem of Enumerable.from(iterable)) { if (equalityComparer(innerKeySelector(innerItem, innerIndex), outerKeySelector(outerItem, outerIndex))) { arr.push(outerItem); } outerIndex++; } yield resultSelector(innerItem, arr); innerIndex++; } }; return new Enumerable(gen); } /// Correlates the elements of two sequences based on matching keys. /// WARNING: using the equality comparer will be slower Enumerable.prototype.join = function (iterable: IterableType, innerKeySelector: ISelector, outerKeySelector: ISelector, resultSelector: (item1: any, item2: any) => any, equalityComparer: IEqualityComparer = EqualityComparer.default): Enumerable { const self: Enumerable = this; const gen = equalityComparer === EqualityComparer.default ? function* () { const lookup = new Enumerable(iterable) .groupBy(outerKeySelector) .toMap(g => g.key, g => g); let index = 0; for (const innerItem of self) { const group = lookup.get(innerKeySelector(innerItem, index)); if (group) { for (const outerItem of group) { yield resultSelector(innerItem, outerItem); } } index++; } } : function* () { let innerIndex = 0; for (const innerItem of self) { let outerIndex = 0; for (const outerItem of Enumerable.from(iterable)) { if (equalityComparer(innerKeySelector(innerItem, innerIndex), outerKeySelector(outerItem, outerIndex))) { yield resultSelector(innerItem, outerItem); } outerIndex++; } innerIndex++; } }; return new Enumerable(gen); } Enumerable.prototype.toLookup = function (): never { throw new Error('use groupBy instead of toLookup'); } /** * An Enumerable that also exposes a group key * * @export * @class GroupEnumerable * @extends {Enumerable} */ export class GroupEnumerable extends Enumerable { key: string; constructor(iterable: IterableType, key: string) { super(iterable); this.key = key; } } } ================================================ FILE: LInQer.OrderedEnumerable.ts ================================================ /// namespace Linqer { export interface Enumerable extends Iterable { /** * Sorts the elements of a sequence in ascending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof Enumerable */ orderBy(keySelector: ISelector): OrderedEnumerable; /** * Sorts the elements of a sequence in descending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof Enumerable */ orderByDescending(keySelector: ISelector): OrderedEnumerable; /** * use QuickSort for ordering (default). Recommended when take, skip, takeLast, skipLast are used after orderBy * * @returns {Enumerable} * @memberof Enumerable */ useQuickSort(): Enumerable; /** * use the default browser sort implementation for ordering at all times * * @returns {Enumerable} * @memberof Enumerable */ useBrowserSort(): Enumerable; } /// Sorts the elements of a sequence in ascending order. Enumerable.prototype.orderBy = function (keySelector: ISelector): OrderedEnumerable { if (keySelector) { _ensureFunction(keySelector); } else { keySelector = item => item; } return new OrderedEnumerable(this, keySelector, true); }; /// Sorts the elements of a sequence in descending order. Enumerable.prototype.orderByDescending = function (keySelector: ISelector): OrderedEnumerable { if (keySelector) { _ensureFunction(keySelector); } else { keySelector = item => item; } return new OrderedEnumerable(this, keySelector, false); }; /// use QuickSort for ordering (default). Recommended when take, skip, takeLast, skipLast are used after orderBy Enumerable.prototype.useQuickSort = function (): Enumerable { this._useQuickSort = true; return this; }; /// use the default browser sort implementation for ordering at all times Enumerable.prototype.useBrowserSort = function (): Enumerable { this._useQuickSort = false; return this; }; //static sort: (arr: any[], comparer?: IComparer) => void; Enumerable.sort = function (arr: any[], comparer: IComparer = _defaultComparer): any[] { _quickSort(arr, 0, arr.length - 1, comparer, 0, Number.MAX_SAFE_INTEGER); return arr; } enum RestrictionType { skip, skipLast, take, takeLast } /** * An Enumerable yielding ordered items * * @export * @class OrderedEnumerable * @extends {Enumerable} */ export class OrderedEnumerable extends Enumerable { _keySelectors: { keySelector: ISelector, ascending: boolean }[]; _restrictions: { type: RestrictionType, nr: number }[]; /** *Creates an instance of OrderedEnumerable. * @param {IterableType} src * @param {ISelector} [keySelector] * @param {boolean} [ascending=true] * @memberof OrderedEnumerable */ constructor(src: IterableType, keySelector?: ISelector, ascending: boolean = true) { super(src); this._keySelectors = []; this._restrictions = []; if (keySelector) { this._keySelectors.push({ keySelector: keySelector, ascending: ascending }); } const self: OrderedEnumerable = this; // generator gets an array of the original, // sorted inside the interval determined by functions such as skip, take, skipLast, takeLast this._generator = function* () { let { startIndex, endIndex, arr } = this.getSortedArray(); if (arr) { for (let index = startIndex; index < endIndex; index++) { yield arr[index]; } } }; // the count is the difference between the end and start indexes // if no skip/take functions were used, this will be the original count this._count = () => { const totalCount = Enumerable.from(self._src).count(); const { startIndex, endIndex } = this.getStartAndEndIndexes(self._restrictions, totalCount); return endIndex - startIndex; }; // an ordered enumerable cannot seek this._canSeek=false; this._tryGetAt = ()=>{ throw new Error('Ordered enumerables cannot seek'); }; } private getSortedArray() { const self = this; let startIndex: number; let endIndex: number; let arr: any[] | null = null; const innerEnumerable = self._src as Enumerable; _ensureInternalTryGetAt(innerEnumerable); // try to avoid enumerating the entire original into an array if (innerEnumerable._canSeek) { ({ startIndex, endIndex } = self.getStartAndEndIndexes(self._restrictions, innerEnumerable.count())); } else { arr = Array.from(self._src); ({ startIndex, endIndex } = self.getStartAndEndIndexes(self._restrictions, arr.length)); } if (startIndex < endIndex) { if (!arr) { arr = Array.from(self._src); } // only quicksort supports partial ordering inside an interval const sort: (item1: any, item2: any) => void = self._useQuickSort ? (a, c) => _quickSort(a, 0, a.length - 1, c, startIndex, endIndex) : (a, c) => a.sort(c); const sortFunc = self.generateSortFunc(self._keySelectors); sort(arr, sortFunc); return { startIndex, endIndex, arr }; } else { return { startIndex, endIndex, arr: null }; } } private generateSortFunc(selectors: { keySelector: ISelector, ascending: boolean }[]): (i1: any, i2: any) => number { // simplify the selectors into an array of comparers const comparers = selectors.map(s => { const f = s.keySelector; const comparer = (i1: any, i2: any) => { const k1 = f(i1); const k2 = f(i2); if (k1 > k2) return 1; if (k1 < k2) return -1; return 0; }; return s.ascending ? comparer : (i1: any, i2: any) => -comparer(i1, i2); }); // optimize the resulting sort function in the most common case // (ordered by a single criterion) return comparers.length == 1 ? comparers[0] : (i1: any, i2: any) => { for (let i = 0; i < comparers.length; i++) { const v = comparers[i](i1, i2); if (v) return v; } return 0; }; } /// calculate the interval in which an array needs to have ordered items for this ordered enumerable private getStartAndEndIndexes(restrictions: { type: RestrictionType, nr: number }[], arrLength: number) { let startIndex = 0; let endIndex = arrLength; for (const restriction of restrictions) { switch (restriction.type) { case RestrictionType.take: endIndex = Math.min(endIndex, startIndex + restriction.nr); break; case RestrictionType.skip: startIndex = Math.min(endIndex, startIndex + restriction.nr); break; case RestrictionType.takeLast: startIndex = Math.max(startIndex, endIndex - restriction.nr); break; case RestrictionType.skipLast: endIndex = Math.max(startIndex, endIndex - restriction.nr); break; } } return { startIndex, endIndex }; } /** * Performs a subsequent ordering of the elements in a sequence in ascending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ thenBy(keySelector: ISelector): OrderedEnumerable { this._keySelectors.push({ keySelector: keySelector, ascending: true }); return this; } /** * Performs a subsequent ordering of the elements in a sequence in descending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ thenByDescending(keySelector: ISelector): OrderedEnumerable { this._keySelectors.push({ keySelector: keySelector, ascending: false }); return this; } /** * Deferred and optimized implementation of take * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ take(nr: number): OrderedEnumerable { this._restrictions.push({ type: RestrictionType.take, nr: nr }); return this; } /** * Deferred and optimized implementation of takeLast * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ takeLast(nr: number): OrderedEnumerable { this._restrictions.push({ type: RestrictionType.takeLast, nr: nr }); return this; } /** * Deferred and optimized implementation of skip * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ skip(nr: number): OrderedEnumerable { this._restrictions.push({ type: RestrictionType.skip, nr: nr }); return this; } /** * Deferred and optimized implementation of skipLast * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ skipLast(nr: number): OrderedEnumerable { this._restrictions.push({ type: RestrictionType.skipLast, nr: nr }); return this; } /** * An optimized implementation of toArray * * @returns {any[]} * @memberof OrderedEnumerable */ toArray(): any[] { const { startIndex, endIndex, arr } = this.getSortedArray(); return arr ? arr.slice(startIndex, endIndex) : []; } /** * An optimized implementation of toMap * * @param {ISelector} keySelector * @param {ISelector} [valueSelector=x => x] * @returns {Map} * @memberof OrderedEnumerable */ toMap(keySelector: ISelector, valueSelector: ISelector = x => x): Map { _ensureFunction(keySelector); _ensureFunction(valueSelector); const result = new Map(); const arr = this.toArray(); for (let i = 0; i < arr.length; i++) { result.set(keySelector(arr[i], i), valueSelector(arr[i], i)); } return result; } /** * An optimized implementation of toObject * * @param {ISelector} keySelector * @param {ISelector} [valueSelector=x => x] * @returns {{ [key: string]: any }} * @memberof OrderedEnumerable */ toObject(keySelector: ISelector, valueSelector: ISelector = x => x): { [key: string]: any } { _ensureFunction(keySelector); _ensureFunction(valueSelector); const result: { [key: string]: any } = {}; const arr = this.toArray(); for (let i = 0; i < arr.length; i++) { result[keySelector(arr[i], i)] = valueSelector(arr[i], i); } return result; } /** * An optimized implementation of to Set * * @returns {Set} * @memberof OrderedEnumerable */ toSet(): Set { const result = new Set(); const arr = this.toArray(); for (let i = 0; i < arr.length; i++) { result.add(arr[i]); } return result; } } const _insertionSortThreshold = 64; /// insertion sort is used for small intervals function _insertionsort(arr: any[], leftIndex: number, rightIndex: number, comparer: IComparer) { for (let j = leftIndex; j <= rightIndex; j++) { const key = arr[j]; let i = j - 1; while (i >= leftIndex && comparer(arr[i], key) > 0) { arr[i + 1] = arr[i]; i--; } arr[i + 1] = key; } } /// swap two items in an array by index function _swapArrayItems(array: any[], leftIndex: number, rightIndex: number): void { const temp = array[leftIndex]; array[leftIndex] = array[rightIndex]; array[rightIndex] = temp; } // Quicksort partition by center value coming from both sides function _partition(items: any[], left: number, right: number, comparer: IComparer) { const pivot = items[(right + left) >> 1]; while (left <= right) { while (comparer(items[left], pivot) < 0) { left++; } while (comparer(items[right], pivot) > 0) { right--; } if (left < right) { _swapArrayItems(items, left, right); left++; right--; } else { if (left === right) return left + 1; } } return left; } /// optimized Quicksort algorithm function _quickSort(items: any[], left: number, right: number, comparer: IComparer = _defaultComparer, minIndex: number = 0, maxIndex: number = Number.MAX_SAFE_INTEGER) { if (!items.length) return items; // store partition indexes to be processed in here const partitions: { left: number, right: number }[] = []; partitions.push({ left, right }); let size = 1; // the actual size of the partitions array never decreases // but we keep score of the number of partitions in 'size' // and we reuse slots whenever possible while (size) { const partition = { left, right } = partitions[size-1]; if (right - left < _insertionSortThreshold) { _insertionsort(items, left, right, comparer); size--; continue; } const index = _partition(items, left, right, comparer); if (left < index - 1 && index - 1 >= minIndex) { partition.right = index - 1; if (index < right && index < maxIndex) { partitions[size]={ left: index, right }; size++; } } else { if (index < right && index < maxIndex) { partition.left = index; } else { size--; } } } return items; } } ================================================ FILE: LInQer.Slim.ts ================================================ namespace Linqer { /** * wrapper class over iterable instances that exposes the methods usually found in .NET LINQ * * @export * @class Enumerable * @implements {Iterable} * @implements {IUsesQuickSort} */ export class Enumerable implements Iterable, IUsesQuickSort { _src: IterableType; _generator: () => Iterator; _useQuickSort: boolean; // indicates that count and elementAt functions will not cause iterating the enumerable _canSeek: boolean; _count: null | (() => number); _tryGetAt: null | ((index: number) => { value: any } | null); // true if the enumerable was iterated at least once _wasIterated: boolean; /** * sort an array in place using the Enumerable sort algorithm (Quicksort) * * @static * @memberof Enumerable */ static sort: (arr: any[], comparer?: IComparer) => any[]; /** * You should never use this. Instead use Enumerable.from * @param {IterableType} src * @memberof Enumerable */ constructor(src: IterableType) { _ensureIterable(src); this._src = src; const iteratorFunction: (() => Iterator) = (src as Iterable)[Symbol.iterator]; // the generator is either the iterator of the source enumerable // or the generator function that was provided as the source itself if (iteratorFunction) { this._generator = iteratorFunction.bind(src); } else { this._generator = src as (() => Iterator); } // set sorting method on an enumerable and all the derived ones should inherit it // TODO: a better method of doing this this._useQuickSort = (src as IUsesQuickSort)._useQuickSort !== undefined ? (src as IUsesQuickSort)._useQuickSort : true; this._canSeek = false; this._count = null; this._tryGetAt = null; this._wasIterated = false; } /** * Wraps an iterable item into an Enumerable if it's not already one * * @static * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ static from(iterable: IterableType): Enumerable { if (iterable instanceof Enumerable) return iterable; return new Enumerable(iterable); } /** * the Enumerable instance exposes the same iterator as the wrapped iterable or generator function * * @returns {Iterator} * @memberof Enumerable */ [Symbol.iterator](): Iterator { this._wasIterated = true; return this._generator(); } /** * returns an empty Enumerable * * @static * @returns {Enumerable} * @memberof Enumerable */ static empty(): Enumerable { const result = new Enumerable([]); result._count = () => 0; result._tryGetAt = (index: number) => null; result._canSeek = true; return result; } /** * generates a sequence of integer numbers within a specified range. * * @static * @param {number} start * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static range(start: number, count: number): Enumerable { const gen = function* () { for (let i = 0; i < count; i++) { yield start + i; } }; const result = new Enumerable(gen); result._count = () => count; result._tryGetAt = index => { if (index >= 0 && index < count) return { value: start + index }; return null; }; result._canSeek = true; return result; } /** * Generates a sequence that contains one repeated value. * * @static * @param {*} item * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static repeat(item: any, count: number): Enumerable { const gen = function* () { for (let i = 0; i < count; i++) { yield item; } }; const result = new Enumerable(gen); result._count = () => count; result._tryGetAt = index => { if (index >= 0 && index < count) return { value: item }; return null; }; result._canSeek = true; return result; } /** * Same value as count(), but will throw an Error if enumerable is not seekable and has to be iterated to get the length */ get length():number { _ensureInternalTryGetAt(this); if (!this._canSeek) throw new Error('Calling length on this enumerable will iterate it. Use count()'); return this.count(); } /** * Concatenates two sequences by appending iterable to the existing one. * * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ concat(iterable: IterableType): Enumerable { _ensureIterable(iterable); const self: Enumerable = this; // the generator will iterate the enumerable first, then the iterable that was given as a parameter // this will be able to seek if both the original and the iterable derived enumerable can seek // the indexing function will get items from the first and then second enumerable without iteration const gen = function* () { for (const item of self) { yield item; } for (const item of Enumerable.from(iterable)) { yield item; } }; const result = new Enumerable(gen); const other = Enumerable.from(iterable); result._count = () => self.count() + other.count(); _ensureInternalTryGetAt(this); _ensureInternalTryGetAt(other); result._canSeek = self._canSeek && other._canSeek; if (self._canSeek) { result._tryGetAt = index => { return self._tryGetAt!(index) || other._tryGetAt!(index - self.count()); }; } return result; } /** * Returns the number of elements in a sequence. * * @returns {number} * @memberof Enumerable */ count(): number { _ensureInternalCount(this); return this._count!(); } /** * Returns distinct elements from a sequence. * WARNING: using a comparer makes this slower. Not specifying it uses a Set to determine distinctiveness. * * @param {IEqualityComparer} [equalityComparer=EqualityComparer.default] * @returns {Enumerable} * @memberof Enumerable */ distinct(equalityComparer: IEqualityComparer = EqualityComparer.default): Enumerable { const self: Enumerable = this; // if the comparer function is not provided, a Set will be used to quickly determine distinctiveness const gen = equalityComparer === EqualityComparer.default ? function* () { const distinctValues = new Set(); for (const item of self) { const size = distinctValues.size; distinctValues.add(item); if (size < distinctValues.size) { yield item; } } } // otherwise values will be compared with previous values ( O(n^2) ) // use distinctByHash in Linqer.extra to use a hashing function ( O(n log n) ) : function* () { const values = []; for (const item of self) { let unique = true; for (let i=0; i 0) agg.max = item; agg.count++; } return agg; } /** * Returns the minimum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ min(comparer?: IComparer): any { const stats = this.stats(comparer); return stats.count === 0 ? undefined : stats.min; } /** * Returns the maximum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ max(comparer?: IComparer): any { const stats = this.stats(comparer); return stats.count === 0 ? undefined : stats.max; } /** * Projects each element of a sequence into a new form. * * @param {ISelector} selector * @returns {Enumerable} * @memberof Enumerable */ select(selector: ISelector): Enumerable { _ensureFunction(selector); const self: Enumerable = this; // the generator is applying the selector on all the items of the enumerable // the count of the resulting enumerable is the same as the original's // the indexer is the same as that of the original, with the selector applied on the value const gen = function* () { let index = 0; for (const item of self) { yield selector(item, index); index++; } }; const result = new Enumerable(gen); _ensureInternalCount(this); result._count = this._count; _ensureInternalTryGetAt(self); result._canSeek = self._canSeek; result._tryGetAt = index => { const res = self._tryGetAt!(index); if (!res) return res; return { value: selector(res.value) }; }; return result; } /** * Bypasses a specified number of elements in a sequence and then returns the remaining elements. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ skip(nr: number): Enumerable { const self: Enumerable = this; // the generator just enumerates the first nr numbers then starts yielding values // the count is the same as the original enumerable, minus the skipped items and at least 0 // the indexer is the same as for the original, with an offset const gen = function* () { let nrLeft = nr; for (const item of self) { if (nrLeft > 0) { nrLeft--; } else { yield item; } } }; const result = new Enumerable(gen); result._count = () => Math.max(0, self.count() - nr); _ensureInternalTryGetAt(this); result._canSeek = this._canSeek; result._tryGetAt = index => self._tryGetAt!(index + nr); return result; } /** * Takes start elements, ignores howmany elements, continues with the new items and continues with the original enumerable * Equivalent to the value of an array after performing splice on it with the same parameters * @param start * @param howmany * @param items * @returns splice */ splice(start: number, howmany: number, ...newItems:any[]) : Enumerable { // tried to define length and splice so that this is seen as an Array-like object, // but it doesn't work on properties. length needs to be a field. return this.take(start).concat(newItems).concat(this.skip(start+howmany)); } /** * Computes the sum of a sequence of numeric values. * * @returns {(number | undefined)} * @memberof Enumerable */ sum(): number | undefined { const stats = this.sumAndCount(); return stats.count === 0 ? undefined : stats.sum; } /** * Computes the sum and count of a sequence of numeric values. * * @returns {{ sum: number, count: number }} * @memberof Enumerable */ sumAndCount(): { sum: number, count: number } { const agg = { count: 0, sum: 0 }; for (const item of this) { agg.sum = agg.count === 0 ? _toNumber(item) : agg.sum + _toNumber(item); agg.count++; } return agg; } /** * Returns a specified number of contiguous elements from the start of a sequence. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ take(nr: number): Enumerable { const self: Enumerable = this; // the generator will stop after nr items yielded // the count is the maximum between the total count and nr // the indexer is the same, as long as it's not higher than nr const gen = function* () { let nrLeft = nr; for (const item of self) { if (nrLeft > 0) { yield item; nrLeft--; } if (nrLeft <= 0) { break; } } }; const result = new Enumerable(gen); result._count = () => Math.min(nr, self.count()); _ensureInternalTryGetAt(this); result._canSeek = self._canSeek; if (self._canSeek) { result._tryGetAt = index => { if (index >= nr) return null; return self._tryGetAt!(index); }; } return result; } /** * creates an array from an Enumerable * * @returns {any[]} * @memberof Enumerable */ toArray(): any[] { _ensureInternalTryGetAt(this); // this should be faster than Array.from(this) if (this._canSeek) { const arr = new Array(this.count()); for (let i = 0; i < arr.length; i++) { arr[i] = this._tryGetAt!(i)?.value; } return arr; } // try to optimize the array growth by increasing it // by 64 every time it is needed const minIncrease = 64; let size = 0; const arr = []; for (const item of this) { if (size === arr.length) { arr.length += minIncrease; } arr[size] = item; size++; } arr.length = size; return arr; } /** * similar to toArray, but returns a seekable Enumerable (itself if already seekable) that can do count and elementAt without iterating * * @returns {Enumerable} * @memberof Enumerable */ toList(): Enumerable { _ensureInternalTryGetAt(this); if (this._canSeek) return this; return Enumerable.from(this.toArray()); } /** * Filters a sequence of values based on a predicate. * * @param {IFilter} condition * @returns {Enumerable} * @memberof Enumerable */ where(condition: IFilter): Enumerable { _ensureFunction(condition); const self: Enumerable = this; // cannot imply the count or indexer from the condition // where will have to iterate through the whole thing const gen = function* () { let index = 0; for (const item of self) { if (condition(item, index)) { yield item; } index++; } }; return new Enumerable(gen); } } // throw if src is not a generator function or an iteratable export function _ensureIterable(src: IterableType): void { if (src) { if ((src as Iterable)[Symbol.iterator]) return; if (typeof src === 'function' && (src as Function).constructor.name === 'GeneratorFunction') return; } throw new Error('the argument must be iterable!'); } // throw if f is not a function export function _ensureFunction(f: Function): void { if (!f || typeof f !== 'function') throw new Error('the argument needs to be a function!'); } // return Nan if this is not a number // different from Number(obj), which would cast strings to numbers function _toNumber(obj: any): number { return typeof obj === 'number' ? obj : Number.NaN; } // return the iterable if already an array or use Array.from to create one export function _toArray(iterable: IterableType) { if (!iterable) return []; if (Array.isArray(iterable)) return iterable; return Array.from(iterable); } // if the internal count function is not defined, set it to the most appropriate one export function _ensureInternalCount(enumerable: Enumerable) { if (enumerable._count) return; if (enumerable._src instanceof Enumerable) { // the count is the same as the underlying enumerable const innerEnumerable = enumerable._src as Enumerable; _ensureInternalCount(innerEnumerable); enumerable._count = () => innerEnumerable._count!(); return; } const src = enumerable._src as any; // this could cause false positives, but if it has a numeric length or size, use it if (typeof src !== 'function' && typeof src.length === 'number') { enumerable._count = () => src.length; return; } if (typeof src.size === 'number') { enumerable._count = () => src.size; return; } // otherwise iterate the whole thing and count all items enumerable._count = () => { let x = 0; for (const item of enumerable) x++; return x; }; } // ensure there is an internal indexer function adequate for this enumerable // this also determines if the enumerable can seek export function _ensureInternalTryGetAt(enumerable: Enumerable) { if (enumerable._tryGetAt) return; enumerable._canSeek = true; if (enumerable._src instanceof Enumerable) { // indexer and seekability is the same as for the underlying enumerable const innerEnumerable = enumerable._src as Enumerable; _ensureInternalTryGetAt(innerEnumerable); enumerable._tryGetAt = index => innerEnumerable._tryGetAt!(index); enumerable._canSeek = innerEnumerable._canSeek; return; } if (typeof enumerable._src === 'string') { // a string can be accessed by index enumerable._tryGetAt = index => { if (index < (enumerable._src as string).length) { return { value: (enumerable._src as string).charAt(index) }; } return null; }; return; } if (Array.isArray(enumerable._src)) { // an array can be accessed by index enumerable._tryGetAt = index => { if (index >= 0 && index < (enumerable._src as any[]).length) { return { value: (enumerable._src as any[])[index] }; } return null; }; return; } const src = enumerable._src as any; if (typeof enumerable._src !== 'function' && typeof src.length === 'number') { // try to access an object with a defined numeric length by indexing it // might cause false positives enumerable._tryGetAt = index => { if (index < src.length && typeof src[index] !== 'undefined') { return { value: src[index] }; } return null; }; return; } enumerable._canSeek = false; // TODO other specialized types? objects, maps, sets? enumerable._tryGetAt = index => { let x = 0; for (const item of enumerable) { if (index === x) return { value: item }; x++; } return null; } } /** * an extended iterable type that also supports generator functions */ export type IterableType = Iterable | (() => Iterator) | Enumerable; /** * A comparer function to be used in sorting */ export type IComparer = (item1: any, item2: any) => -1 | 0 | 1; /** * A selector function to be used in mapping */ export type ISelector = (item: any, index?: number) => T; /** * A filter function */ export type IFilter = ISelector; /** * The default comparer function between two items * @param item1 * @param item2 */ export const _defaultComparer: IComparer = (item1, item2) => { if (item1 > item2) return 1; if (item1 < item2) return -1; return 0; }; /** * Interface for an equality comparer */ export type IEqualityComparer = (item1: any, item2: any) => boolean; /** * Predefined equality comparers * default is the equivalent of == * exact is the equivalent of === */ export const EqualityComparer = { default: (item1: any, item2: any) => item1 == item2, exact: (item1: any, item2: any) => item1 === item2, }; // used to access the variable determining if // an enumerable should be ordered using Quicksort or not interface IUsesQuickSort { _useQuickSort: boolean; } } ================================================ FILE: LInQer.all.d.ts ================================================ declare namespace Linqer { /** * wrapper class over iterable instances that exposes the methods usually found in .NET LINQ * * @export * @class Enumerable * @implements {Iterable} * @implements {IUsesQuickSort} */ export class Enumerable implements Iterable, IUsesQuickSort { _src: IterableType; _generator: () => Iterator; _useQuickSort: boolean; _canSeek: boolean; _count: null | (() => number); _tryGetAt: null | ((index: number) => { value: any; } | null); _wasIterated: boolean; /** * sort an array in place using the Enumerable sort algorithm (Quicksort) * * @static * @memberof Enumerable */ static sort: (arr: any[], comparer?: IComparer) => any[]; /** * You should never use this. Instead use Enumerable.from * @param {IterableType} src * @memberof Enumerable */ constructor(src: IterableType); /** * Wraps an iterable item into an Enumerable if it's not already one * * @static * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ static from(iterable: IterableType): Enumerable; /** * the Enumerable instance exposes the same iterator as the wrapped iterable or generator function * * @returns {Iterator} * @memberof Enumerable */ [Symbol.iterator](): Iterator; /** * returns an empty Enumerable * * @static * @returns {Enumerable} * @memberof Enumerable */ static empty(): Enumerable; /** * generates a sequence of integer numbers within a specified range. * * @static * @param {number} start * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static range(start: number, count: number): Enumerable; /** * Generates a sequence that contains one repeated value. * * @static * @param {*} item * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static repeat(item: any, count: number): Enumerable; /** * Same value as count(), but will throw an Error if enumerable is not seekable and has to be iterated to get the length */ get length(): number; /** * Concatenates two sequences by appending iterable to the existing one. * * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ concat(iterable: IterableType): Enumerable; /** * Returns distinct elements from a sequence. * WARNING: using a comparer makes this slower. Not specifying it uses a Set to determine distinctiveness. * * @param {IEqualityComparer} [equalityComparer=EqualityComparer.default] * @returns {Enumerable} * @memberof Enumerable */ distinct(equalityComparer?: IEqualityComparer): Enumerable; /** * Returns the element at a specified index in a sequence. * * @param {number} index * @returns {*} * @memberof Enumerable */ elementAt(index: number): any; /** * Returns the element at a specified index in a sequence or undefined if the index is out of range. * * @param {number} index * @returns {(any | undefined)} * @memberof Enumerable */ elementAtOrDefault(index: number): any | undefined; /** * Returns the first element of a sequence. * * @returns {*} * @memberof Enumerable */ first(): any; /** * Returns the first element of a sequence, or a default value if no element is found. * * @returns {(any | undefined)} * @memberof Enumerable */ firstOrDefault(): any | undefined; /** * Returns the last element of a sequence. * * @returns {*} * @memberof Enumerable */ last(): any; /** * Returns the last element of a sequence, or undefined if no element is found. * * @returns {(any | undefined)} * @memberof Enumerable */ lastOrDefault(): any | undefined; /** * Returns the count, minimum and maximum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {{ count: number, min: any, max: any }} * @memberof Enumerable */ stats(comparer?: IComparer): { count: number; min: any; max: any; }; /** * Returns the minimum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ min(comparer?: IComparer): any; /** * Returns the maximum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ max(comparer?: IComparer): any; /** * Projects each element of a sequence into a new form. * * @param {ISelector} selector * @returns {Enumerable} * @memberof Enumerable */ select(selector: ISelector): Enumerable; /** * Bypasses a specified number of elements in a sequence and then returns the remaining elements. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ skip(nr: number): Enumerable; /** * Takes start elements, ignores howmany elements, continues with the new items and continues with the original enumerable * Equivalent to the value of an array after performing splice on it with the same parameters * @param start * @param howmany * @param items * @returns splice */ splice(start: number, howmany: number, ...newItems: any[]): Enumerable; /** * Computes the sum of a sequence of numeric values. * * @returns {(number | undefined)} * @memberof Enumerable */ sum(): number | undefined; /** * Computes the sum and count of a sequence of numeric values. * * @returns {{ sum: number, count: number }} * @memberof Enumerable */ sumAndCount(): { sum: number; count: number; }; /** * Returns a specified number of contiguous elements from the start of a sequence. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ take(nr: number): Enumerable; /** * creates an array from an Enumerable * * @returns {any[]} * @memberof Enumerable */ toArray(): any[]; /** * similar to toArray, but returns a seekable Enumerable (itself if already seekable) that can do count and elementAt without iterating * * @returns {Enumerable} * @memberof Enumerable */ toList(): Enumerable; /** * Filters a sequence of values based on a predicate. * * @param {IFilter} condition * @returns {Enumerable} * @memberof Enumerable */ where(condition: IFilter): Enumerable; } export function _ensureIterable(src: IterableType): void; export function _ensureFunction(f: Function): void; export function _toArray(iterable: IterableType): any[]; export function _ensureInternalCount(enumerable: Enumerable): void; export function _ensureInternalTryGetAt(enumerable: Enumerable): void; /** * an extended iterable type that also supports generator functions */ export type IterableType = Iterable | (() => Iterator) | Enumerable; /** * A comparer function to be used in sorting */ export type IComparer = (item1: any, item2: any) => -1 | 0 | 1; /** * A selector function to be used in mapping */ export type ISelector = (item: any, index?: number) => T; /** * A filter function */ export type IFilter = ISelector; /** * The default comparer function between two items * @param item1 * @param item2 */ export const _defaultComparer: IComparer; /** * Interface for an equality comparer */ export type IEqualityComparer = (item1: any, item2: any) => boolean; /** * Predefined equality comparers * default is the equivalent of == * exact is the equivalent of === */ export const EqualityComparer: { default: (item1: any, item2: any) => boolean; exact: (item1: any, item2: any) => boolean; }; interface IUsesQuickSort { _useQuickSort: boolean; } export {}; } declare namespace Linqer { interface Enumerable extends Iterable { /** * Applies an accumulator function over a sequence. * The specified seed value is used as the initial accumulator value, and the specified function is used to select the result value. * * @param {*} accumulator * @param {(acc: any, item: any) => any} aggregator * @returns {*} * @memberof Enumerable */ aggregate(accumulator: any, aggregator: (acc: any, item: any) => any): any; /** * Determines whether all elements of a sequence satisfy a condition. * @param condition * @returns true if all */ all(condition: IFilter): boolean; /** * Determines whether any element of a sequence exists or satisfies a condition. * * @param {IFilter} condition * @returns {boolean} * @memberof Enumerable */ any(condition: IFilter): boolean; /** * Appends a value to the end of the sequence. * * @param {*} item * @returns {Enumerable} * @memberof Enumerable */ append(item: any): Enumerable; /** * Computes the average of a sequence of numeric values. * * @returns {(number | undefined)} * @memberof Enumerable */ average(): number | undefined; /** * Returns itself * * @returns {Enumerable} * @memberof Enumerable */ asEnumerable(): Enumerable; /** * Checks the elements of a sequence based on their type * If type is a string, it will check based on typeof, else it will use instanceof. * Throws if types are different. * @param {(string | Function)} type * @returns {Enumerable} * @memberof Enumerable */ cast(type: string | Function): Enumerable; /** * Determines whether a sequence contains a specified element. * A custom function can be used to determine equality between elements. * * @param {*} item * @param {IEqualityComparer} equalityComparer * @returns {boolean} * @memberof Enumerable */ contains(item: any, equalityComparer: IEqualityComparer): boolean; defaultIfEmpty(): never; /** * Produces the set difference of two sequences * WARNING: using the comparer is slower * * @param {IterableType} iterable * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ except(iterable: IterableType, equalityComparer: IEqualityComparer): Enumerable; /** * Produces the set intersection of two sequences. * WARNING: using a comparer is slower * * @param {IterableType} iterable * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ intersect(iterable: IterableType, equalityComparer: IEqualityComparer): Enumerable; /** * Same as count * * @returns {number} * @memberof Enumerable */ longCount(): number; /** * Filters the elements of a sequence based on their type * If type is a string, it will filter based on typeof, else it will use instanceof * * @param {(string | Function)} type * @returns {Enumerable} * @memberof Enumerable */ ofType(type: string | Function): Enumerable; /** * Adds a value to the beginning of the sequence. * * @param {*} item * @returns {Enumerable} * @memberof Enumerable */ prepend(item: any): Enumerable; /** * Inverts the order of the elements in a sequence. * * @returns {Enumerable} * @memberof Enumerable */ reverse(): Enumerable; /** * Projects each element of a sequence to an iterable and flattens the resulting sequences into one sequence. * * @param {ISelector} selector * @returns {Enumerable} * @memberof Enumerable */ selectMany(selector: ISelector): Enumerable; /** * Determines whether two sequences are equal and in the same order according to an optional equality comparer. * * @param {IterableType} iterable * @param {IEqualityComparer} equalityComparer * @returns {boolean} * @memberof Enumerable */ sequenceEqual(iterable: IterableType, equalityComparer: IEqualityComparer): boolean; /** * Returns the single element of a sequence and throws if it doesn't have exactly one * * @returns {*} * @memberof Enumerable */ single(): any; /** * Returns the single element of a sequence or undefined if none found. It throws if the sequence contains multiple items. * * @returns {(any | undefined)} * @memberof Enumerable */ singleOrDefault(): any | undefined; /** * Returns a new enumerable collection that contains the elements from source with the last nr elements of the source collection omitted. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ skipLast(nr: number): Enumerable; /** * Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. * * @param {IFilter} condition * @returns {Enumerable} * @memberof Enumerable */ skipWhile(condition: IFilter): Enumerable; /** * Selects the elements starting at the given start argument, and ends at, but does not include, the given end argument. * @param start * @param end * @returns slice */ slice(start: number | undefined, end: number | undefined): Enumerable; /** * Returns a new enumerable collection that contains the last nr elements from source. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ takeLast(nr: number): Enumerable; /** * Returns elements from a sequence as long as a specified condition is true, and then skips the remaining elements. * * @param {IFilter} condition * @returns {Enumerable} * @memberof Enumerable */ takeWhile(condition: IFilter): Enumerable; toDictionary(): never; /** * creates a Map from an Enumerable * * @param {ISelector} keySelector * @param {ISelector} valueSelector * @returns {Map} * @memberof Enumerable */ toMap(keySelector: ISelector, valueSelector: ISelector): Map; /** * creates an object from an Enumerable * * @param {ISelector} keySelector * @param {ISelector} valueSelector * @returns {{ [key: string]: any }} * @memberof Enumerable */ toObject(keySelector: ISelector, valueSelector: ISelector): { [key: string]: any; }; toHashSet(): never; /** * creates a Set from an enumerable * * @returns {Set} * @memberof Enumerable */ toSet(): Set; /** * Produces the set union of two sequences. * * @param {IterableType} iterable * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ union(iterable: IterableType, equalityComparer: IEqualityComparer): Enumerable; /** * Applies a specified function to the corresponding elements of two sequences, producing a sequence of the results. * * @param {IterableType} iterable * @param {(item1: any, item2: any, index: number) => any} zipper * @returns {*} * @memberof Enumerable */ zip(iterable: IterableType, zipper: (item1: any, item2: any, index: number) => any): any; } } declare namespace Linqer { interface Enumerable extends Iterable { /** * Groups the elements of a sequence. * * @param {ISelector} keySelector * @returns {Enumerable} * @memberof Enumerable */ groupBy(keySelector: ISelector): Enumerable; /** * Correlates the elements of two sequences based on key equality and groups the results. A specified equalityComparer is used to compare keys. * WARNING: using the equality comparer will be slower * * @param {IterableType} iterable * @param {ISelector} innerKeySelector * @param {ISelector} outerKeySelector * @param {(item1: any, item2: any) => any} resultSelector * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ groupJoin(iterable: IterableType, innerKeySelector: ISelector, outerKeySelector: ISelector, resultSelector: (item1: any, item2: any) => any, equalityComparer: IEqualityComparer): Enumerable; /** * Correlates the elements of two sequences based on matching keys. * WARNING: using the equality comparer will be slower * * @param {IterableType} iterable * @param {ISelector} innerKeySelector * @param {ISelector} outerKeySelector * @param {(item1: any, item2: any) => any} resultSelector * @param {IEqualityComparer} equalityComparer * @returns {Enumerable} * @memberof Enumerable */ join(iterable: IterableType, innerKeySelector: ISelector, outerKeySelector: ISelector, resultSelector: (item1: any, item2: any) => any, equalityComparer: IEqualityComparer): Enumerable; toLookup(): never; } /** * An Enumerable that also exposes a group key * * @export * @class GroupEnumerable * @extends {Enumerable} */ class GroupEnumerable extends Enumerable { key: string; constructor(iterable: IterableType, key: string); } } declare namespace Linqer { export interface Enumerable extends Iterable { /** * Sorts the elements of a sequence in ascending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof Enumerable */ orderBy(keySelector: ISelector): OrderedEnumerable; /** * Sorts the elements of a sequence in descending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof Enumerable */ orderByDescending(keySelector: ISelector): OrderedEnumerable; /** * use QuickSort for ordering (default). Recommended when take, skip, takeLast, skipLast are used after orderBy * * @returns {Enumerable} * @memberof Enumerable */ useQuickSort(): Enumerable; /** * use the default browser sort implementation for ordering at all times * * @returns {Enumerable} * @memberof Enumerable */ useBrowserSort(): Enumerable; } enum RestrictionType { skip = 0, skipLast = 1, take = 2, takeLast = 3 } /** * An Enumerable yielding ordered items * * @export * @class OrderedEnumerable * @extends {Enumerable} */ export class OrderedEnumerable extends Enumerable { _keySelectors: { keySelector: ISelector; ascending: boolean; }[]; _restrictions: { type: RestrictionType; nr: number; }[]; /** *Creates an instance of OrderedEnumerable. * @param {IterableType} src * @param {ISelector} [keySelector] * @param {boolean} [ascending=true] * @memberof OrderedEnumerable */ constructor(src: IterableType, keySelector?: ISelector, ascending?: boolean); private getSortedArray; private generateSortFunc; private getStartAndEndIndexes; /** * Performs a subsequent ordering of the elements in a sequence in ascending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ thenBy(keySelector: ISelector): OrderedEnumerable; /** * Performs a subsequent ordering of the elements in a sequence in descending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ thenByDescending(keySelector: ISelector): OrderedEnumerable; /** * Deferred and optimized implementation of take * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ take(nr: number): OrderedEnumerable; /** * Deferred and optimized implementation of takeLast * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ takeLast(nr: number): OrderedEnumerable; /** * Deferred and optimized implementation of skip * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ skip(nr: number): OrderedEnumerable; /** * Deferred and optimized implementation of skipLast * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ skipLast(nr: number): OrderedEnumerable; /** * An optimized implementation of toArray * * @returns {any[]} * @memberof OrderedEnumerable */ toArray(): any[]; /** * An optimized implementation of toMap * * @param {ISelector} keySelector * @param {ISelector} [valueSelector=x => x] * @returns {Map} * @memberof OrderedEnumerable */ toMap(keySelector: ISelector, valueSelector?: ISelector): Map; /** * An optimized implementation of toObject * * @param {ISelector} keySelector * @param {ISelector} [valueSelector=x => x] * @returns {{ [key: string]: any }} * @memberof OrderedEnumerable */ toObject(keySelector: ISelector, valueSelector?: ISelector): { [key: string]: any; }; /** * An optimized implementation of to Set * * @returns {Set} * @memberof OrderedEnumerable */ toSet(): Set; } export {}; } declare namespace Linqer { interface Enumerable extends Iterable { /** * Returns a randomized sequence of items from an initial source * @returns shuffle */ shuffle(): Enumerable; /** * implements random reservoir sampling of k items, with the option to specify a maximum limit for the items * @param k * @param limit * @returns sample */ randomSample(k: number, limit: number): Enumerable; /** * Returns the count of the items in a sequence. Depending on the sequence type this iterates through it or not. * @returns count */ count(): number; /** * returns the distinct values based on a hashing function * * @param {ISelector} hashFunc * @returns {Enumerable} * @memberof Enumerable */ distinctByHash(hashFunc: ISelector): Enumerable; /** * returns the values that have different hashes from the items of the iterable provided * * @param {IterableType} iterable * @param {ISelector} hashFunc * @returns {Enumerable} * @memberof Enumerable */ exceptByHash(iterable: IterableType, hashFunc: ISelector): Enumerable; /** * returns the values that have the same hashes as items of the iterable provided * * @param {IterableType} iterable * @param {ISelector} hashFunc * @returns {Enumerable} * @memberof Enumerable */ intersectByHash(iterable: IterableType, hashFunc: ISelector): Enumerable; /** * returns the index of a value in an ordered enumerable or false if not found * WARNING: use the same comparer as the one used to order the enumerable. The algorithm assumes the enumerable is already sorted. * * @param {*} value * @param {IComparer} comparer * @returns {(number | boolean)} * @memberof Enumerable */ binarySearch(value: any, comparer: IComparer): number | boolean; /** * joins each item of the enumerable with previous items from the same enumerable * @param offset * @param zipper * @returns lag */ lag(offset: number, zipper: (item1: any, item2: any) => any): Enumerable; /** * joins each item of the enumerable with next items from the same enumerable * * @param {number} offset * @param {(item1: any, item2: any) => any} zipper * @returns {Enumerable} * @memberof Enumerable */ lead(offset: number, zipper: (item1: any, item2: any) => any): Enumerable; /** * returns an enumerable of at least minLength, padding the end with a value or the result of a function * * @param {number} minLength * @param {(any | ((index: number) => any))} filler * @returns {Enumerable} * @memberof Enumerable */ padEnd(minLength: number, filler: any | ((index: number) => any)): Enumerable; /** * returns an enumerable of at least minLength, padding the start with a value or the result of a function * if the enumerable cannot seek, then it will be iterated minLength time * * @param {number} minLength * @param {(any | ((index: number) => any))} filler * @returns {Enumerable} * @memberof Enumerable */ padStart(minLength: number, filler: any | ((index: number) => any)): Enumerable; } } export = Linqer; ================================================ FILE: LInQer.all.js ================================================ "use strict"; var Linqer; (function (Linqer) { /** * wrapper class over iterable instances that exposes the methods usually found in .NET LINQ * * @export * @class Enumerable * @implements {Iterable} * @implements {IUsesQuickSort} */ class Enumerable { /** * You should never use this. Instead use Enumerable.from * @param {IterableType} src * @memberof Enumerable */ constructor(src) { _ensureIterable(src); this._src = src; const iteratorFunction = src[Symbol.iterator]; // the generator is either the iterator of the source enumerable // or the generator function that was provided as the source itself if (iteratorFunction) { this._generator = iteratorFunction.bind(src); } else { this._generator = src; } // set sorting method on an enumerable and all the derived ones should inherit it // TODO: a better method of doing this this._useQuickSort = src._useQuickSort !== undefined ? src._useQuickSort : true; this._canSeek = false; this._count = null; this._tryGetAt = null; this._wasIterated = false; } /** * Wraps an iterable item into an Enumerable if it's not already one * * @static * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ static from(iterable) { if (iterable instanceof Enumerable) return iterable; return new Enumerable(iterable); } /** * the Enumerable instance exposes the same iterator as the wrapped iterable or generator function * * @returns {Iterator} * @memberof Enumerable */ [Symbol.iterator]() { this._wasIterated = true; return this._generator(); } /** * returns an empty Enumerable * * @static * @returns {Enumerable} * @memberof Enumerable */ static empty() { const result = new Enumerable([]); result._count = () => 0; result._tryGetAt = (index) => null; result._canSeek = true; return result; } /** * generates a sequence of integer numbers within a specified range. * * @static * @param {number} start * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static range(start, count) { const gen = function* () { for (let i = 0; i < count; i++) { yield start + i; } }; const result = new Enumerable(gen); result._count = () => count; result._tryGetAt = index => { if (index >= 0 && index < count) return { value: start + index }; return null; }; result._canSeek = true; return result; } /** * Generates a sequence that contains one repeated value. * * @static * @param {*} item * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static repeat(item, count) { const gen = function* () { for (let i = 0; i < count; i++) { yield item; } }; const result = new Enumerable(gen); result._count = () => count; result._tryGetAt = index => { if (index >= 0 && index < count) return { value: item }; return null; }; result._canSeek = true; return result; } /** * Same value as count(), but will throw an Error if enumerable is not seekable and has to be iterated to get the length */ get length() { _ensureInternalTryGetAt(this); if (!this._canSeek) throw new Error('Calling length on this enumerable will iterate it. Use count()'); return this.count(); } /** * Concatenates two sequences by appending iterable to the existing one. * * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ concat(iterable) { _ensureIterable(iterable); const self = this; // the generator will iterate the enumerable first, then the iterable that was given as a parameter // this will be able to seek if both the original and the iterable derived enumerable can seek // the indexing function will get items from the first and then second enumerable without iteration const gen = function* () { for (const item of self) { yield item; } for (const item of Enumerable.from(iterable)) { yield item; } }; const result = new Enumerable(gen); const other = Enumerable.from(iterable); result._count = () => self.count() + other.count(); _ensureInternalTryGetAt(this); _ensureInternalTryGetAt(other); result._canSeek = self._canSeek && other._canSeek; if (self._canSeek) { result._tryGetAt = index => { return self._tryGetAt(index) || other._tryGetAt(index - self.count()); }; } return result; } /** * Returns the number of elements in a sequence. * * @returns {number} * @memberof Enumerable */ count() { _ensureInternalCount(this); return this._count(); } /** * Returns distinct elements from a sequence. * WARNING: using a comparer makes this slower. Not specifying it uses a Set to determine distinctiveness. * * @param {IEqualityComparer} [equalityComparer=EqualityComparer.default] * @returns {Enumerable} * @memberof Enumerable */ distinct(equalityComparer = Linqer.EqualityComparer.default) { const self = this; // if the comparer function is not provided, a Set will be used to quickly determine distinctiveness const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const distinctValues = new Set(); for (const item of self) { const size = distinctValues.size; distinctValues.add(item); if (size < distinctValues.size) { yield item; } } } // otherwise values will be compared with previous values ( O(n^2) ) // use distinctByHash in Linqer.extra to use a hashing function ( O(n log n) ) : function* () { const values = []; for (const item of self) { let unique = true; for (let i = 0; i < values.length; i++) { if (equalityComparer(item, values[i])) { unique = false; break; } } if (unique) yield item; values.push(item); } }; return new Enumerable(gen); } /** * Returns the element at a specified index in a sequence. * * @param {number} index * @returns {*} * @memberof Enumerable */ elementAt(index) { _ensureInternalTryGetAt(this); const result = this._tryGetAt(index); if (!result) throw new Error('Index out of range'); return result.value; } /** * Returns the element at a specified index in a sequence or undefined if the index is out of range. * * @param {number} index * @returns {(any | undefined)} * @memberof Enumerable */ elementAtOrDefault(index) { _ensureInternalTryGetAt(this); const result = this._tryGetAt(index); if (!result) return undefined; return result.value; } /** * Returns the first element of a sequence. * * @returns {*} * @memberof Enumerable */ first() { return this.elementAt(0); } /** * Returns the first element of a sequence, or a default value if no element is found. * * @returns {(any | undefined)} * @memberof Enumerable */ firstOrDefault() { return this.elementAtOrDefault(0); } /** * Returns the last element of a sequence. * * @returns {*} * @memberof Enumerable */ last() { _ensureInternalTryGetAt(this); // if this cannot seek, getting the last element requires iterating the whole thing if (!this._canSeek) { let result = null; let found = false; for (const item of this) { result = item; found = true; } if (found) return result; throw new Error('The enumeration is empty'); } // if this can seek, then just go directly at the last element const count = this.count(); return this.elementAt(count - 1); } /** * Returns the last element of a sequence, or undefined if no element is found. * * @returns {(any | undefined)} * @memberof Enumerable */ lastOrDefault() { _ensureInternalTryGetAt(this); if (!this._canSeek) { let result = undefined; for (const item of this) { result = item; } return result; } const count = this.count(); return this.elementAtOrDefault(count - 1); } /** * Returns the count, minimum and maximum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {{ count: number, min: any, max: any }} * @memberof Enumerable */ stats(comparer) { if (comparer) { _ensureFunction(comparer); } else { comparer = Linqer._defaultComparer; } const agg = { count: 0, min: undefined, max: undefined }; for (const item of this) { if (typeof agg.min === 'undefined' || comparer(item, agg.min) < 0) agg.min = item; if (typeof agg.max === 'undefined' || comparer(item, agg.max) > 0) agg.max = item; agg.count++; } return agg; } /** * Returns the minimum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ min(comparer) { const stats = this.stats(comparer); return stats.count === 0 ? undefined : stats.min; } /** * Returns the maximum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ max(comparer) { const stats = this.stats(comparer); return stats.count === 0 ? undefined : stats.max; } /** * Projects each element of a sequence into a new form. * * @param {ISelector} selector * @returns {Enumerable} * @memberof Enumerable */ select(selector) { _ensureFunction(selector); const self = this; // the generator is applying the selector on all the items of the enumerable // the count of the resulting enumerable is the same as the original's // the indexer is the same as that of the original, with the selector applied on the value const gen = function* () { let index = 0; for (const item of self) { yield selector(item, index); index++; } }; const result = new Enumerable(gen); _ensureInternalCount(this); result._count = this._count; _ensureInternalTryGetAt(self); result._canSeek = self._canSeek; result._tryGetAt = index => { const res = self._tryGetAt(index); if (!res) return res; return { value: selector(res.value) }; }; return result; } /** * Bypasses a specified number of elements in a sequence and then returns the remaining elements. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ skip(nr) { const self = this; // the generator just enumerates the first nr numbers then starts yielding values // the count is the same as the original enumerable, minus the skipped items and at least 0 // the indexer is the same as for the original, with an offset const gen = function* () { let nrLeft = nr; for (const item of self) { if (nrLeft > 0) { nrLeft--; } else { yield item; } } }; const result = new Enumerable(gen); result._count = () => Math.max(0, self.count() - nr); _ensureInternalTryGetAt(this); result._canSeek = this._canSeek; result._tryGetAt = index => self._tryGetAt(index + nr); return result; } /** * Takes start elements, ignores howmany elements, continues with the new items and continues with the original enumerable * Equivalent to the value of an array after performing splice on it with the same parameters * @param start * @param howmany * @param items * @returns splice */ splice(start, howmany, ...newItems) { // tried to define length and splice so that this is seen as an Array-like object, // but it doesn't work on properties. length needs to be a field. return this.take(start).concat(newItems).concat(this.skip(start + howmany)); } /** * Computes the sum of a sequence of numeric values. * * @returns {(number | undefined)} * @memberof Enumerable */ sum() { const stats = this.sumAndCount(); return stats.count === 0 ? undefined : stats.sum; } /** * Computes the sum and count of a sequence of numeric values. * * @returns {{ sum: number, count: number }} * @memberof Enumerable */ sumAndCount() { const agg = { count: 0, sum: 0 }; for (const item of this) { agg.sum = agg.count === 0 ? _toNumber(item) : agg.sum + _toNumber(item); agg.count++; } return agg; } /** * Returns a specified number of contiguous elements from the start of a sequence. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ take(nr) { const self = this; // the generator will stop after nr items yielded // the count is the maximum between the total count and nr // the indexer is the same, as long as it's not higher than nr const gen = function* () { let nrLeft = nr; for (const item of self) { if (nrLeft > 0) { yield item; nrLeft--; } if (nrLeft <= 0) { break; } } }; const result = new Enumerable(gen); result._count = () => Math.min(nr, self.count()); _ensureInternalTryGetAt(this); result._canSeek = self._canSeek; if (self._canSeek) { result._tryGetAt = index => { if (index >= nr) return null; return self._tryGetAt(index); }; } return result; } /** * creates an array from an Enumerable * * @returns {any[]} * @memberof Enumerable */ toArray() { var _a; _ensureInternalTryGetAt(this); // this should be faster than Array.from(this) if (this._canSeek) { const arr = new Array(this.count()); for (let i = 0; i < arr.length; i++) { arr[i] = (_a = this._tryGetAt(i)) === null || _a === void 0 ? void 0 : _a.value; } return arr; } // try to optimize the array growth by increasing it // by 64 every time it is needed const minIncrease = 64; let size = 0; const arr = []; for (const item of this) { if (size === arr.length) { arr.length += minIncrease; } arr[size] = item; size++; } arr.length = size; return arr; } /** * similar to toArray, but returns a seekable Enumerable (itself if already seekable) that can do count and elementAt without iterating * * @returns {Enumerable} * @memberof Enumerable */ toList() { _ensureInternalTryGetAt(this); if (this._canSeek) return this; return Enumerable.from(this.toArray()); } /** * Filters a sequence of values based on a predicate. * * @param {IFilter} condition * @returns {Enumerable} * @memberof Enumerable */ where(condition) { _ensureFunction(condition); const self = this; // cannot imply the count or indexer from the condition // where will have to iterate through the whole thing const gen = function* () { let index = 0; for (const item of self) { if (condition(item, index)) { yield item; } index++; } }; return new Enumerable(gen); } } Linqer.Enumerable = Enumerable; // throw if src is not a generator function or an iteratable function _ensureIterable(src) { if (src) { if (src[Symbol.iterator]) return; if (typeof src === 'function' && src.constructor.name === 'GeneratorFunction') return; } throw new Error('the argument must be iterable!'); } Linqer._ensureIterable = _ensureIterable; // throw if f is not a function function _ensureFunction(f) { if (!f || typeof f !== 'function') throw new Error('the argument needs to be a function!'); } Linqer._ensureFunction = _ensureFunction; // return Nan if this is not a number // different from Number(obj), which would cast strings to numbers function _toNumber(obj) { return typeof obj === 'number' ? obj : Number.NaN; } // return the iterable if already an array or use Array.from to create one function _toArray(iterable) { if (!iterable) return []; if (Array.isArray(iterable)) return iterable; return Array.from(iterable); } Linqer._toArray = _toArray; // if the internal count function is not defined, set it to the most appropriate one function _ensureInternalCount(enumerable) { if (enumerable._count) return; if (enumerable._src instanceof Enumerable) { // the count is the same as the underlying enumerable const innerEnumerable = enumerable._src; _ensureInternalCount(innerEnumerable); enumerable._count = () => innerEnumerable._count(); return; } const src = enumerable._src; // this could cause false positives, but if it has a numeric length or size, use it if (typeof src !== 'function' && typeof src.length === 'number') { enumerable._count = () => src.length; return; } if (typeof src.size === 'number') { enumerable._count = () => src.size; return; } // otherwise iterate the whole thing and count all items enumerable._count = () => { let x = 0; for (const item of enumerable) x++; return x; }; } Linqer._ensureInternalCount = _ensureInternalCount; // ensure there is an internal indexer function adequate for this enumerable // this also determines if the enumerable can seek function _ensureInternalTryGetAt(enumerable) { if (enumerable._tryGetAt) return; enumerable._canSeek = true; if (enumerable._src instanceof Enumerable) { // indexer and seekability is the same as for the underlying enumerable const innerEnumerable = enumerable._src; _ensureInternalTryGetAt(innerEnumerable); enumerable._tryGetAt = index => innerEnumerable._tryGetAt(index); enumerable._canSeek = innerEnumerable._canSeek; return; } if (typeof enumerable._src === 'string') { // a string can be accessed by index enumerable._tryGetAt = index => { if (index < enumerable._src.length) { return { value: enumerable._src.charAt(index) }; } return null; }; return; } if (Array.isArray(enumerable._src)) { // an array can be accessed by index enumerable._tryGetAt = index => { if (index >= 0 && index < enumerable._src.length) { return { value: enumerable._src[index] }; } return null; }; return; } const src = enumerable._src; if (typeof enumerable._src !== 'function' && typeof src.length === 'number') { // try to access an object with a defined numeric length by indexing it // might cause false positives enumerable._tryGetAt = index => { if (index < src.length && typeof src[index] !== 'undefined') { return { value: src[index] }; } return null; }; return; } enumerable._canSeek = false; // TODO other specialized types? objects, maps, sets? enumerable._tryGetAt = index => { let x = 0; for (const item of enumerable) { if (index === x) return { value: item }; x++; } return null; }; } Linqer._ensureInternalTryGetAt = _ensureInternalTryGetAt; /** * The default comparer function between two items * @param item1 * @param item2 */ Linqer._defaultComparer = (item1, item2) => { if (item1 > item2) return 1; if (item1 < item2) return -1; return 0; }; /** * Predefined equality comparers * default is the equivalent of == * exact is the equivalent of === */ Linqer.EqualityComparer = { default: (item1, item2) => item1 == item2, exact: (item1, item2) => item1 === item2, }; })(Linqer || (Linqer = {})); /// var Linqer; /// (function (Linqer) { /// Applies an accumulator function over a sequence. /// The specified seed value is used as the initial accumulator value, and the specified function is used to select the result value. Linqer.Enumerable.prototype.aggregate = function (accumulator, aggregator) { Linqer._ensureFunction(aggregator); for (const item of this) { accumulator = aggregator(accumulator, item); } return accumulator; }; /// Determines whether all elements of a sequence satisfy a condition. Linqer.Enumerable.prototype.all = function (condition) { Linqer._ensureFunction(condition); return !this.any(x => !condition(x)); }; /// Determines whether any element of a sequence exists or satisfies a condition. Linqer.Enumerable.prototype.any = function (condition) { Linqer._ensureFunction(condition); let index = 0; for (const item of this) { if (condition(item, index)) return true; index++; } return false; }; /// Appends a value to the end of the sequence. Linqer.Enumerable.prototype.append = function (item) { return this.concat([item]); }; /// Computes the average of a sequence of numeric values. Linqer.Enumerable.prototype.average = function () { const stats = this.sumAndCount(); return stats.count === 0 ? undefined : stats.sum / stats.count; }; /// Returns the same enumerable Linqer.Enumerable.prototype.asEnumerable = function () { return this; }; /// Checks the elements of a sequence based on their type /// If type is a string, it will check based on typeof, else it will use instanceof. /// Throws if types are different. Linqer.Enumerable.prototype.cast = function (type) { const f = typeof type === 'string' ? x => typeof x === type : x => x instanceof type; return this.select(item => { if (!f(item)) throw new Error(item + ' not of type ' + type); return item; }); }; /// Determines whether a sequence contains a specified element. /// A custom function can be used to determine equality between elements. Linqer.Enumerable.prototype.contains = function (item, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureFunction(equalityComparer); return this.any(x => equalityComparer(x, item)); }; Linqer.Enumerable.prototype.defaultIfEmpty = function () { throw new Error('defaultIfEmpty not implemented for Javascript'); }; /// Produces the set difference of two sequences WARNING: using the comparer is slower Linqer.Enumerable.prototype.except = function (iterable, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureIterable(iterable); const self = this; // use a Set for performance if the comparer is not set const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const distinctValues = Linqer.Enumerable.from(iterable).toSet(); for (const item of self) { if (!distinctValues.has(item)) yield item; } } // use exceptByHash from Linqer.extra for better performance : function* () { const values = Linqer._toArray(iterable); for (const item of self) { let unique = true; for (let i = 0; i < values.length; i++) { if (equalityComparer(item, values[i])) { unique = false; break; } } if (unique) yield item; } }; return new Linqer.Enumerable(gen); }; /// Produces the set intersection of two sequences. WARNING: using a comparer is slower Linqer.Enumerable.prototype.intersect = function (iterable, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureIterable(iterable); const self = this; // use a Set for performance if the comparer is not set const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const distinctValues = new Set(Linqer.Enumerable.from(iterable)); for (const item of self) { if (distinctValues.has(item)) yield item; } } // use intersectByHash from Linqer.extra for better performance : function* () { const values = Linqer._toArray(iterable); for (const item of self) { let unique = true; for (let i = 0; i < values.length; i++) { if (equalityComparer(item, values[i])) { unique = false; break; } } if (!unique) yield item; } }; return new Linqer.Enumerable(gen); }; /// same as count Linqer.Enumerable.prototype.longCount = function () { return this.count(); }; /// Filters the elements of a sequence based on their type /// If type is a string, it will filter based on typeof, else it will use instanceof Linqer.Enumerable.prototype.ofType = function (type) { const condition = typeof type === 'string' ? x => typeof x === type : x => x instanceof type; return this.where(condition); }; /// Adds a value to the beginning of the sequence. Linqer.Enumerable.prototype.prepend = function (item) { return new Linqer.Enumerable([item]).concat(this); }; /// Inverts the order of the elements in a sequence. Linqer.Enumerable.prototype.reverse = function () { Linqer._ensureInternalTryGetAt(this); const self = this; // if it can seek, just read the enumerable backwards const gen = this._canSeek ? function* () { const length = self.count(); for (let index = length - 1; index >= 0; index--) { yield self.elementAt(index); } } // else enumerate it all into an array, then read it backwards : function* () { const arr = self.toArray(); for (let index = arr.length - 1; index >= 0; index--) { yield arr[index]; } }; // the count is the same when reversed const result = new Linqer.Enumerable(gen); Linqer._ensureInternalCount(this); result._count = this._count; Linqer._ensureInternalTryGetAt(this); // have a custom indexer only if the original enumerable could seek if (this._canSeek) { const self = this; result._canSeek = true; result._tryGetAt = index => self._tryGetAt(self.count() - index - 1); } return result; }; /// Projects each element of a sequence to an iterable and flattens the resulting sequences into one sequence. Linqer.Enumerable.prototype.selectMany = function (selector) { if (typeof selector !== 'undefined') { Linqer._ensureFunction(selector); } else { selector = x => x; } const self = this; const gen = function* () { let index = 0; for (const item of self) { const iter = selector(item, index); Linqer._ensureIterable(iter); for (const child of iter) { yield child; } index++; } }; return new Linqer.Enumerable(gen); }; /// Determines whether two sequences are equal and in the same order according to an equality comparer. Linqer.Enumerable.prototype.sequenceEqual = function (iterable, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureIterable(iterable); Linqer._ensureFunction(equalityComparer); const iterator1 = this[Symbol.iterator](); const iterator2 = Linqer.Enumerable.from(iterable)[Symbol.iterator](); let done = false; do { const val1 = iterator1.next(); const val2 = iterator2.next(); const equal = (val1.done && val2.done) || (!val1.done && !val2.done && equalityComparer(val1.value, val2.value)); if (!equal) return false; done = !!val1.done; } while (!done); return true; }; /// Returns the single element of a sequence and throws if it doesn't have exactly one Linqer.Enumerable.prototype.single = function () { const iterator = this[Symbol.iterator](); let val = iterator.next(); if (val.done) throw new Error('Sequence contains no elements'); const result = val.value; val = iterator.next(); if (!val.done) throw new Error('Sequence contains more than one element'); return result; }; /// Returns the single element of a sequence or undefined if none found. It throws if the sequence contains multiple items. Linqer.Enumerable.prototype.singleOrDefault = function () { const iterator = this[Symbol.iterator](); let val = iterator.next(); if (val.done) return undefined; const result = val.value; val = iterator.next(); if (!val.done) throw new Error('Sequence contains more than one element'); return result; }; /// Selects the elements starting at the given start argument, and ends at, but does not include, the given end argument. Linqer.Enumerable.prototype.slice = function (start = 0, end) { let enumerable = this; // when the end is defined and positive and start is negative, // the only way to compute the last index is to know the count if (end !== undefined && end >= 0 && (start || 0) < 0) { enumerable = enumerable.toList(); start = enumerable.count() + start; } if (start !== 0) { if (start > 0) { enumerable = enumerable.skip(start); } else { enumerable = enumerable.takeLast(-start); } } if (end !== undefined) { if (end >= 0) { enumerable = enumerable.take(end - start); } else { enumerable = enumerable.skipLast(-end); } } return enumerable; }; /// Returns a new enumerable collection that contains the elements from source with the last nr elements of the source collection omitted. Linqer.Enumerable.prototype.skipLast = function (nr) { const self = this; // the generator is using a buffer to cache nr values // and only yields the values that overflow from it const gen = function* () { let nrLeft = nr; const buffer = Array(nrLeft); let index = 0; let offset = 0; for (const item of self) { const value = buffer[index - offset]; buffer[index - offset] = item; index++; if (index - offset >= nrLeft) { offset += nrLeft; } if (index > nrLeft) { yield value; } } buffer.length = 0; }; const result = new Linqer.Enumerable(gen); // the count is the original count minus the skipped items and at least 0 result._count = () => Math.max(0, self.count() - nr); Linqer._ensureInternalTryGetAt(this); result._canSeek = this._canSeek; // it has an indexer only if the original enumerable can seek if (this._canSeek) { result._tryGetAt = index => { if (index >= result.count()) return null; return self._tryGetAt(index); }; } return result; }; /// Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. Linqer.Enumerable.prototype.skipWhile = function (condition) { Linqer._ensureFunction(condition); const self = this; let skip = true; const gen = function* () { let index = 0; for (const item of self) { if (skip && !condition(item, index)) { skip = false; } if (!skip) { yield item; } index++; } }; return new Linqer.Enumerable(gen); }; /// Returns a new enumerable collection that contains the last nr elements from source. Linqer.Enumerable.prototype.takeLast = function (nr) { Linqer._ensureInternalTryGetAt(this); const self = this; const gen = this._canSeek // taking the last items is easy if the enumerable can seek ? function* () { let nrLeft = nr; const length = self.count(); for (let index = length - nrLeft; index < length; index++) { yield self.elementAt(index); } } // else the generator uses a buffer to fill with values // and yields them after the entire thing has been iterated : function* () { let nrLeft = nr; let index = 0; const buffer = Array(nrLeft); for (const item of self) { buffer[index % nrLeft] = item; index++; } for (let i = 0; i < nrLeft && i < index; i++) { yield buffer[(index + i) % nrLeft]; } }; const result = new Linqer.Enumerable(gen); // the count is the minimum between nr and the enumerable count result._count = () => Math.min(nr, self.count()); result._canSeek = self._canSeek; // this can seek only if the original enumerable could seek if (self._canSeek) { result._tryGetAt = index => { if (index < 0 || index >= result.count()) return null; return self._tryGetAt(self.count() - nr + index); }; } return result; }; /// Returns elements from a sequence as long as a specified condition is true, and then skips the remaining elements. Linqer.Enumerable.prototype.takeWhile = function (condition) { Linqer._ensureFunction(condition); const self = this; const gen = function* () { let index = 0; for (const item of self) { if (condition(item, index)) { yield item; } else { break; } index++; } }; return new Linqer.Enumerable(gen); }; Linqer.Enumerable.prototype.toDictionary = function () { throw new Error('use toMap or toObject instead of toDictionary'); }; /// creates a map from an Enumerable Linqer.Enumerable.prototype.toMap = function (keySelector, valueSelector = x => x) { Linqer._ensureFunction(keySelector); Linqer._ensureFunction(valueSelector); const result = new Map(); let index = 0; for (const item of this) { result.set(keySelector(item, index), valueSelector(item, index)); index++; } return result; }; /// creates an object from an enumerable Linqer.Enumerable.prototype.toObject = function (keySelector, valueSelector = x => x) { Linqer._ensureFunction(keySelector); Linqer._ensureFunction(valueSelector); const result = {}; let index = 0; for (const item of this) { result[keySelector(item, index)] = valueSelector(item); index++; } return result; }; Linqer.Enumerable.prototype.toHashSet = function () { throw new Error('use toSet instead of toHashSet'); }; /// creates a set from an enumerable Linqer.Enumerable.prototype.toSet = function () { const result = new Set(); for (const item of this) { result.add(item); } return result; }; /// Produces the set union of two sequences. Linqer.Enumerable.prototype.union = function (iterable, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureIterable(iterable); return this.concat(iterable).distinct(equalityComparer); }; /// Applies a specified function to the corresponding elements of two sequences, producing a sequence of the results. Linqer.Enumerable.prototype.zip = function (iterable, zipper) { Linqer._ensureIterable(iterable); if (!zipper) { zipper = (i1, i2) => [i1, i2]; } else { Linqer._ensureFunction(zipper); } const self = this; const gen = function* () { let index = 0; const iterator1 = self[Symbol.iterator](); const iterator2 = Linqer.Enumerable.from(iterable)[Symbol.iterator](); let done = false; do { const val1 = iterator1.next(); const val2 = iterator2.next(); done = !!(val1.done || val2.done); if (!done) { yield zipper(val1.value, val2.value, index); } index++; } while (!done); }; return new Linqer.Enumerable(gen); }; })(Linqer || (Linqer = {})); /// var Linqer; /// (function (Linqer) { /// Groups the elements of a sequence. Linqer.Enumerable.prototype.groupBy = function (keySelector) { Linqer._ensureFunction(keySelector); const self = this; const gen = function* () { const groupMap = new Map(); let index = 0; // iterate all items and group them in a Map for (const item of self) { const key = keySelector(item, index); const group = groupMap.get(key); if (group) { group.push(item); } else { groupMap.set(key, [item]); } index++; } // then yield a GroupEnumerable for each group for (const [key, items] of groupMap) { const group = new GroupEnumerable(items, key); yield group; } }; const result = new Linqer.Enumerable(gen); return result; }; /// Correlates the elements of two sequences based on key equality and groups the results. A specified equalityComparer is used to compare keys. /// WARNING: using the equality comparer will be slower Linqer.Enumerable.prototype.groupJoin = function (iterable, innerKeySelector, outerKeySelector, resultSelector, equalityComparer = Linqer.EqualityComparer.default) { const self = this; const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const lookup = new Linqer.Enumerable(iterable) .groupBy(outerKeySelector) .toMap(g => g.key, g => g); let index = 0; for (const innerItem of self) { const arr = Linqer._toArray(lookup.get(innerKeySelector(innerItem, index))); yield resultSelector(innerItem, arr); index++; } } : function* () { let innerIndex = 0; for (const innerItem of self) { const arr = []; let outerIndex = 0; for (const outerItem of Linqer.Enumerable.from(iterable)) { if (equalityComparer(innerKeySelector(innerItem, innerIndex), outerKeySelector(outerItem, outerIndex))) { arr.push(outerItem); } outerIndex++; } yield resultSelector(innerItem, arr); innerIndex++; } }; return new Linqer.Enumerable(gen); }; /// Correlates the elements of two sequences based on matching keys. /// WARNING: using the equality comparer will be slower Linqer.Enumerable.prototype.join = function (iterable, innerKeySelector, outerKeySelector, resultSelector, equalityComparer = Linqer.EqualityComparer.default) { const self = this; const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const lookup = new Linqer.Enumerable(iterable) .groupBy(outerKeySelector) .toMap(g => g.key, g => g); let index = 0; for (const innerItem of self) { const group = lookup.get(innerKeySelector(innerItem, index)); if (group) { for (const outerItem of group) { yield resultSelector(innerItem, outerItem); } } index++; } } : function* () { let innerIndex = 0; for (const innerItem of self) { let outerIndex = 0; for (const outerItem of Linqer.Enumerable.from(iterable)) { if (equalityComparer(innerKeySelector(innerItem, innerIndex), outerKeySelector(outerItem, outerIndex))) { yield resultSelector(innerItem, outerItem); } outerIndex++; } innerIndex++; } }; return new Linqer.Enumerable(gen); }; Linqer.Enumerable.prototype.toLookup = function () { throw new Error('use groupBy instead of toLookup'); }; /** * An Enumerable that also exposes a group key * * @export * @class GroupEnumerable * @extends {Enumerable} */ class GroupEnumerable extends Linqer.Enumerable { constructor(iterable, key) { super(iterable); this.key = key; } } Linqer.GroupEnumerable = GroupEnumerable; })(Linqer || (Linqer = {})); /// var Linqer; /// (function (Linqer) { /// Sorts the elements of a sequence in ascending order. Linqer.Enumerable.prototype.orderBy = function (keySelector) { if (keySelector) { Linqer._ensureFunction(keySelector); } else { keySelector = item => item; } return new OrderedEnumerable(this, keySelector, true); }; /// Sorts the elements of a sequence in descending order. Linqer.Enumerable.prototype.orderByDescending = function (keySelector) { if (keySelector) { Linqer._ensureFunction(keySelector); } else { keySelector = item => item; } return new OrderedEnumerable(this, keySelector, false); }; /// use QuickSort for ordering (default). Recommended when take, skip, takeLast, skipLast are used after orderBy Linqer.Enumerable.prototype.useQuickSort = function () { this._useQuickSort = true; return this; }; /// use the default browser sort implementation for ordering at all times Linqer.Enumerable.prototype.useBrowserSort = function () { this._useQuickSort = false; return this; }; //static sort: (arr: any[], comparer?: IComparer) => void; Linqer.Enumerable.sort = function (arr, comparer = Linqer._defaultComparer) { _quickSort(arr, 0, arr.length - 1, comparer, 0, Number.MAX_SAFE_INTEGER); return arr; }; let RestrictionType; (function (RestrictionType) { RestrictionType[RestrictionType["skip"] = 0] = "skip"; RestrictionType[RestrictionType["skipLast"] = 1] = "skipLast"; RestrictionType[RestrictionType["take"] = 2] = "take"; RestrictionType[RestrictionType["takeLast"] = 3] = "takeLast"; })(RestrictionType || (RestrictionType = {})); /** * An Enumerable yielding ordered items * * @export * @class OrderedEnumerable * @extends {Enumerable} */ class OrderedEnumerable extends Linqer.Enumerable { /** *Creates an instance of OrderedEnumerable. * @param {IterableType} src * @param {ISelector} [keySelector] * @param {boolean} [ascending=true] * @memberof OrderedEnumerable */ constructor(src, keySelector, ascending = true) { super(src); this._keySelectors = []; this._restrictions = []; if (keySelector) { this._keySelectors.push({ keySelector: keySelector, ascending: ascending }); } const self = this; // generator gets an array of the original, // sorted inside the interval determined by functions such as skip, take, skipLast, takeLast this._generator = function* () { let { startIndex, endIndex, arr } = this.getSortedArray(); if (arr) { for (let index = startIndex; index < endIndex; index++) { yield arr[index]; } } }; // the count is the difference between the end and start indexes // if no skip/take functions were used, this will be the original count this._count = () => { const totalCount = Linqer.Enumerable.from(self._src).count(); const { startIndex, endIndex } = this.getStartAndEndIndexes(self._restrictions, totalCount); return endIndex - startIndex; }; // an ordered enumerable cannot seek this._canSeek = false; this._tryGetAt = () => { throw new Error('Ordered enumerables cannot seek'); }; } getSortedArray() { const self = this; let startIndex; let endIndex; let arr = null; const innerEnumerable = self._src; Linqer._ensureInternalTryGetAt(innerEnumerable); // try to avoid enumerating the entire original into an array if (innerEnumerable._canSeek) { ({ startIndex, endIndex } = self.getStartAndEndIndexes(self._restrictions, innerEnumerable.count())); } else { arr = Array.from(self._src); ({ startIndex, endIndex } = self.getStartAndEndIndexes(self._restrictions, arr.length)); } if (startIndex < endIndex) { if (!arr) { arr = Array.from(self._src); } // only quicksort supports partial ordering inside an interval const sort = self._useQuickSort ? (a, c) => _quickSort(a, 0, a.length - 1, c, startIndex, endIndex) : (a, c) => a.sort(c); const sortFunc = self.generateSortFunc(self._keySelectors); sort(arr, sortFunc); return { startIndex, endIndex, arr }; } else { return { startIndex, endIndex, arr: null }; } } generateSortFunc(selectors) { // simplify the selectors into an array of comparers const comparers = selectors.map(s => { const f = s.keySelector; const comparer = (i1, i2) => { const k1 = f(i1); const k2 = f(i2); if (k1 > k2) return 1; if (k1 < k2) return -1; return 0; }; return s.ascending ? comparer : (i1, i2) => -comparer(i1, i2); }); // optimize the resulting sort function in the most common case // (ordered by a single criterion) return comparers.length == 1 ? comparers[0] : (i1, i2) => { for (let i = 0; i < comparers.length; i++) { const v = comparers[i](i1, i2); if (v) return v; } return 0; }; } /// calculate the interval in which an array needs to have ordered items for this ordered enumerable getStartAndEndIndexes(restrictions, arrLength) { let startIndex = 0; let endIndex = arrLength; for (const restriction of restrictions) { switch (restriction.type) { case RestrictionType.take: endIndex = Math.min(endIndex, startIndex + restriction.nr); break; case RestrictionType.skip: startIndex = Math.min(endIndex, startIndex + restriction.nr); break; case RestrictionType.takeLast: startIndex = Math.max(startIndex, endIndex - restriction.nr); break; case RestrictionType.skipLast: endIndex = Math.max(startIndex, endIndex - restriction.nr); break; } } return { startIndex, endIndex }; } /** * Performs a subsequent ordering of the elements in a sequence in ascending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ thenBy(keySelector) { this._keySelectors.push({ keySelector: keySelector, ascending: true }); return this; } /** * Performs a subsequent ordering of the elements in a sequence in descending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ thenByDescending(keySelector) { this._keySelectors.push({ keySelector: keySelector, ascending: false }); return this; } /** * Deferred and optimized implementation of take * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ take(nr) { this._restrictions.push({ type: RestrictionType.take, nr: nr }); return this; } /** * Deferred and optimized implementation of takeLast * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ takeLast(nr) { this._restrictions.push({ type: RestrictionType.takeLast, nr: nr }); return this; } /** * Deferred and optimized implementation of skip * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ skip(nr) { this._restrictions.push({ type: RestrictionType.skip, nr: nr }); return this; } /** * Deferred and optimized implementation of skipLast * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ skipLast(nr) { this._restrictions.push({ type: RestrictionType.skipLast, nr: nr }); return this; } /** * An optimized implementation of toArray * * @returns {any[]} * @memberof OrderedEnumerable */ toArray() { const { startIndex, endIndex, arr } = this.getSortedArray(); return arr ? arr.slice(startIndex, endIndex) : []; } /** * An optimized implementation of toMap * * @param {ISelector} keySelector * @param {ISelector} [valueSelector=x => x] * @returns {Map} * @memberof OrderedEnumerable */ toMap(keySelector, valueSelector = x => x) { Linqer._ensureFunction(keySelector); Linqer._ensureFunction(valueSelector); const result = new Map(); const arr = this.toArray(); for (let i = 0; i < arr.length; i++) { result.set(keySelector(arr[i], i), valueSelector(arr[i], i)); } return result; } /** * An optimized implementation of toObject * * @param {ISelector} keySelector * @param {ISelector} [valueSelector=x => x] * @returns {{ [key: string]: any }} * @memberof OrderedEnumerable */ toObject(keySelector, valueSelector = x => x) { Linqer._ensureFunction(keySelector); Linqer._ensureFunction(valueSelector); const result = {}; const arr = this.toArray(); for (let i = 0; i < arr.length; i++) { result[keySelector(arr[i], i)] = valueSelector(arr[i], i); } return result; } /** * An optimized implementation of to Set * * @returns {Set} * @memberof OrderedEnumerable */ toSet() { const result = new Set(); const arr = this.toArray(); for (let i = 0; i < arr.length; i++) { result.add(arr[i]); } return result; } } Linqer.OrderedEnumerable = OrderedEnumerable; const _insertionSortThreshold = 64; /// insertion sort is used for small intervals function _insertionsort(arr, leftIndex, rightIndex, comparer) { for (let j = leftIndex; j <= rightIndex; j++) { const key = arr[j]; let i = j - 1; while (i >= leftIndex && comparer(arr[i], key) > 0) { arr[i + 1] = arr[i]; i--; } arr[i + 1] = key; } } /// swap two items in an array by index function _swapArrayItems(array, leftIndex, rightIndex) { const temp = array[leftIndex]; array[leftIndex] = array[rightIndex]; array[rightIndex] = temp; } // Quicksort partition by center value coming from both sides function _partition(items, left, right, comparer) { const pivot = items[(right + left) >> 1]; while (left <= right) { while (comparer(items[left], pivot) < 0) { left++; } while (comparer(items[right], pivot) > 0) { right--; } if (left < right) { _swapArrayItems(items, left, right); left++; right--; } else { if (left === right) return left + 1; } } return left; } /// optimized Quicksort algorithm function _quickSort(items, left, right, comparer = Linqer._defaultComparer, minIndex = 0, maxIndex = Number.MAX_SAFE_INTEGER) { if (!items.length) return items; // store partition indexes to be processed in here const partitions = []; partitions.push({ left, right }); let size = 1; // the actual size of the partitions array never decreases // but we keep score of the number of partitions in 'size' // and we reuse slots whenever possible while (size) { const partition = { left, right } = partitions[size - 1]; if (right - left < _insertionSortThreshold) { _insertionsort(items, left, right, comparer); size--; continue; } const index = _partition(items, left, right, comparer); if (left < index - 1 && index - 1 >= minIndex) { partition.right = index - 1; if (index < right && index < maxIndex) { partitions[size] = { left: index, right }; size++; } } else { if (index < right && index < maxIndex) { partition.left = index; } else { size--; } } } return items; } })(Linqer || (Linqer = {})); /// /// /// var Linqer; /// /// /// (function (Linqer) { /// randomizes the enumerable (partial Fisher-Yates) Linqer.Enumerable.prototype.shuffle = function () { const self = this; function* gen() { const arr = self.toArray(); const len = arr.length; let n = 0; while (n < len) { let k = n + Math.floor(Math.random() * (len - n)); const value = arr[k]; arr[k] = arr[n]; arr[n] = value; n++; yield value; } } const result = Linqer.Enumerable.from(gen); result._count = () => self.count(); return result; }; /// implements random reservoir sampling of k items, with the option to specify a maximum limit for the items Linqer.Enumerable.prototype.randomSample = function (k, limit = Number.MAX_SAFE_INTEGER) { let index = 0; const sample = []; Linqer._ensureInternalTryGetAt(this); if (this._canSeek) { // L algorithm const length = this.count(); let index = 0; for (index = 0; index < k && index < limit && index < length; index++) { sample.push(this.elementAt(index)); } let W = Math.exp(Math.log(Math.random()) / k); while (index < length && index < limit) { index += Math.floor(Math.log(Math.random()) / Math.log(1 - W)) + 1; if (index < length && index < limit) { sample[Math.floor(Math.random() * k)] = this.elementAt(index); W *= Math.exp(Math.log(Math.random()) / k); } } } else { // R algorithm for (const item of this) { if (index < k) { sample.push(item); } else { const j = Math.floor(Math.random() * index); if (j < k) { sample[j] = item; } } index++; if (index >= limit) break; } } return Linqer.Enumerable.from(sample); }; /// returns the distinct values based on a hashing function Linqer.Enumerable.prototype.distinctByHash = function (hashFunc) { // this is much more performant than distinct with a custom comparer const self = this; const gen = function* () { const distinctValues = new Set(); for (const item of self) { const size = distinctValues.size; distinctValues.add(hashFunc(item)); if (size < distinctValues.size) { yield item; } } }; return new Linqer.Enumerable(gen); }; /// returns the values that have different hashes from the items of the iterable provided Linqer.Enumerable.prototype.exceptByHash = function (iterable, hashFunc) { // this is much more performant than except with a custom comparer Linqer._ensureIterable(iterable); const self = this; const gen = function* () { const distinctValues = Linqer.Enumerable.from(iterable).select(hashFunc).toSet(); for (const item of self) { if (!distinctValues.has(hashFunc(item))) { yield item; } } }; return new Linqer.Enumerable(gen); }; /// returns the values that have the same hashes as items of the iterable provided Linqer.Enumerable.prototype.intersectByHash = function (iterable, hashFunc) { // this is much more performant than intersect with a custom comparer Linqer._ensureIterable(iterable); const self = this; const gen = function* () { const distinctValues = Linqer.Enumerable.from(iterable).select(hashFunc).toSet(); for (const item of self) { if (distinctValues.has(hashFunc(item))) { yield item; } } }; return new Linqer.Enumerable(gen); }; /// returns the index of a value in an ordered enumerable or false if not found /// WARNING: use the same comparer as the one used in the ordered enumerable. The algorithm assumes the enumerable is already sorted. Linqer.Enumerable.prototype.binarySearch = function (value, comparer = Linqer._defaultComparer) { let enumerable = this.toList(); let start = 0; let end = enumerable.count() - 1; while (start <= end) { const mid = (start + end) >> 1; const comp = comparer(enumerable.elementAt(mid), value); if (comp == 0) return mid; if (comp < 0) { start = mid + 1; } else { end = mid - 1; } } return false; }; /// joins each item of the enumerable with previous items from the same enumerable Linqer.Enumerable.prototype.lag = function (offset, zipper) { if (!offset) { throw new Error('offset has to be positive'); } if (offset < 0) { throw new Error('offset has to be positive. Use .lead if you want to join with next items'); } if (!zipper) { zipper = (i1, i2) => [i1, i2]; } else { Linqer._ensureFunction(zipper); } const self = this; Linqer._ensureInternalTryGetAt(this); // generator uses a buffer to hold all the items within the offset interval const gen = function* () { const buffer = Array(offset); let index = 0; for (const item of self) { const index2 = index - offset; const item2 = index2 < 0 ? undefined : buffer[index2 % offset]; yield zipper(item, item2); buffer[index % offset] = item; index++; } }; const result = new Linqer.Enumerable(gen); // count is the same as of the original enumerable result._count = () => { const count = self.count(); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible only if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index) => { const val1 = self._tryGetAt(index); const val2 = self._tryGetAt(index - offset); if (val1) { return { value: zipper(val1.value, val2 ? val2.value : undefined) }; } return null; }; } return result; }; /// joins each item of the enumerable with next items from the same enumerable Linqer.Enumerable.prototype.lead = function (offset, zipper) { if (!offset) { throw new Error('offset has to be positive'); } if (offset < 0) { throw new Error('offset has to be positive. Use .lag if you want to join with previous items'); } if (!zipper) { zipper = (i1, i2) => [i1, i2]; } else { Linqer._ensureFunction(zipper); } const self = this; Linqer._ensureInternalTryGetAt(this); // generator uses a buffer to hold all the items within the offset interval const gen = function* () { const buffer = Array(offset); let index = 0; for (const item of self) { const index2 = index - offset; if (index2 >= 0) { const item2 = buffer[index2 % offset]; yield zipper(item2, item); } buffer[index % offset] = item; index++; } for (let i = 0; i < offset; i++) { const item = buffer[(index + i) % offset]; yield zipper(item, undefined); } }; const result = new Linqer.Enumerable(gen); // count is the same as of the original enumerable result._count = () => { const count = self.count(); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible only if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index) => { const val1 = self._tryGetAt(index); const val2 = self._tryGetAt(index + offset); if (val1) { return { value: zipper(val1.value, val2 ? val2.value : undefined) }; } return null; }; } return result; }; /// returns an enumerable of at least minLength, padding the end with a value or the result of a function Linqer.Enumerable.prototype.padEnd = function (minLength, filler) { if (minLength <= 0) { throw new Error('minLength has to be positive.'); } let fillerFunc; if (typeof filler !== 'function') { fillerFunc = (index) => filler; } else { fillerFunc = filler; } const self = this; Linqer._ensureInternalTryGetAt(this); // generator iterates all elements, // then yields the result of the filler function until minLength items const gen = function* () { let index = 0; for (const item of self) { yield item; index++; } for (; index < minLength; index++) { yield fillerFunc(index); } }; const result = new Linqer.Enumerable(gen); // count is the maximum between minLength and the original count result._count = () => { const count = Math.max(minLength, self.count()); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index) => { const val = self._tryGetAt(index); if (val) return val; if (index < minLength) { return { value: fillerFunc(index) }; } return null; }; } return result; }; /// returns an enumerable of at least minLength, padding the start with a value or the result of a function /// if the enumerable cannot seek, then it will be iterated minLength time Linqer.Enumerable.prototype.padStart = function (minLength, filler) { if (minLength <= 0) { throw new Error('minLength has to be positive.'); } let fillerFunc; if (typeof filler !== 'function') { fillerFunc = (index) => filler; } else { fillerFunc = filler; } const self = this; Linqer._ensureInternalTryGetAt(self); // generator needs a buffer to hold offset values // it yields values from the buffer when it overflows // or filler function results if the buffer is not full // after iterating the entire original enumerable const gen = function* () { const buffer = Array(minLength); let index = 0; const iterator = self[Symbol.iterator](); let flushed = false; let done = false; do { const val = iterator.next(); done = !!val.done; if (!done) { buffer[index] = val.value; index++; } if (flushed && !done) { yield val.value; } else { if (done || index === minLength) { for (let i = 0; i < minLength - index; i++) { yield fillerFunc(i); } for (let i = 0; i < index; i++) { yield buffer[i]; } flushed = true; } } } while (!done); }; const result = new Linqer.Enumerable(gen); // count is the max of minLength and the original count result._count = () => { const count = Math.max(minLength, self.count()); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible only if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index) => { const count = self.count(); const delta = minLength - count; if (delta <= 0) { return self._tryGetAt(index); } if (index < delta) { return { value: fillerFunc(index) }; } return self._tryGetAt(index - delta); }; } return result; }; })(Linqer || (Linqer = {})); // export to NPM if (typeof (module) !== 'undefined') { module.exports = Linqer; } //# sourceMappingURL=LInQer.all.js.map ================================================ FILE: LInQer.extra.js ================================================ "use strict"; /// /// /// var Linqer; /// /// /// (function (Linqer) { /// randomizes the enumerable (partial Fisher-Yates) Linqer.Enumerable.prototype.shuffle = function () { const self = this; function* gen() { const arr = self.toArray(); const len = arr.length; let n = 0; while (n < len) { let k = n + Math.floor(Math.random() * (len - n)); const value = arr[k]; arr[k] = arr[n]; arr[n] = value; n++; yield value; } } const result = Linqer.Enumerable.from(gen); result._count = () => self.count(); return result; }; /// implements random reservoir sampling of k items, with the option to specify a maximum limit for the items Linqer.Enumerable.prototype.randomSample = function (k, limit = Number.MAX_SAFE_INTEGER) { let index = 0; const sample = []; Linqer._ensureInternalTryGetAt(this); if (this._canSeek) { // L algorithm const length = this.count(); let index = 0; for (index = 0; index < k && index < limit && index < length; index++) { sample.push(this.elementAt(index)); } let W = Math.exp(Math.log(Math.random()) / k); while (index < length && index < limit) { index += Math.floor(Math.log(Math.random()) / Math.log(1 - W)) + 1; if (index < length && index < limit) { sample[Math.floor(Math.random() * k)] = this.elementAt(index); W *= Math.exp(Math.log(Math.random()) / k); } } } else { // R algorithm for (const item of this) { if (index < k) { sample.push(item); } else { const j = Math.floor(Math.random() * index); if (j < k) { sample[j] = item; } } index++; if (index >= limit) break; } } return Linqer.Enumerable.from(sample); }; /// returns the distinct values based on a hashing function Linqer.Enumerable.prototype.distinctByHash = function (hashFunc) { // this is much more performant than distinct with a custom comparer const self = this; const gen = function* () { const distinctValues = new Set(); for (const item of self) { const size = distinctValues.size; distinctValues.add(hashFunc(item)); if (size < distinctValues.size) { yield item; } } }; return new Linqer.Enumerable(gen); }; /// returns the values that have different hashes from the items of the iterable provided Linqer.Enumerable.prototype.exceptByHash = function (iterable, hashFunc) { // this is much more performant than except with a custom comparer Linqer._ensureIterable(iterable); const self = this; const gen = function* () { const distinctValues = Linqer.Enumerable.from(iterable).select(hashFunc).toSet(); for (const item of self) { if (!distinctValues.has(hashFunc(item))) { yield item; } } }; return new Linqer.Enumerable(gen); }; /// returns the values that have the same hashes as items of the iterable provided Linqer.Enumerable.prototype.intersectByHash = function (iterable, hashFunc) { // this is much more performant than intersect with a custom comparer Linqer._ensureIterable(iterable); const self = this; const gen = function* () { const distinctValues = Linqer.Enumerable.from(iterable).select(hashFunc).toSet(); for (const item of self) { if (distinctValues.has(hashFunc(item))) { yield item; } } }; return new Linqer.Enumerable(gen); }; /// returns the index of a value in an ordered enumerable or false if not found /// WARNING: use the same comparer as the one used in the ordered enumerable. The algorithm assumes the enumerable is already sorted. Linqer.Enumerable.prototype.binarySearch = function (value, comparer = Linqer._defaultComparer) { let enumerable = this.toList(); let start = 0; let end = enumerable.count() - 1; while (start <= end) { const mid = (start + end) >> 1; const comp = comparer(enumerable.elementAt(mid), value); if (comp == 0) return mid; if (comp < 0) { start = mid + 1; } else { end = mid - 1; } } return false; }; /// joins each item of the enumerable with previous items from the same enumerable Linqer.Enumerable.prototype.lag = function (offset, zipper) { if (!offset) { throw new Error('offset has to be positive'); } if (offset < 0) { throw new Error('offset has to be positive. Use .lead if you want to join with next items'); } if (!zipper) { zipper = (i1, i2) => [i1, i2]; } else { Linqer._ensureFunction(zipper); } const self = this; Linqer._ensureInternalTryGetAt(this); // generator uses a buffer to hold all the items within the offset interval const gen = function* () { const buffer = Array(offset); let index = 0; for (const item of self) { const index2 = index - offset; const item2 = index2 < 0 ? undefined : buffer[index2 % offset]; yield zipper(item, item2); buffer[index % offset] = item; index++; } }; const result = new Linqer.Enumerable(gen); // count is the same as of the original enumerable result._count = () => { const count = self.count(); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible only if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index) => { const val1 = self._tryGetAt(index); const val2 = self._tryGetAt(index - offset); if (val1) { return { value: zipper(val1.value, val2 ? val2.value : undefined) }; } return null; }; } return result; }; /// joins each item of the enumerable with next items from the same enumerable Linqer.Enumerable.prototype.lead = function (offset, zipper) { if (!offset) { throw new Error('offset has to be positive'); } if (offset < 0) { throw new Error('offset has to be positive. Use .lag if you want to join with previous items'); } if (!zipper) { zipper = (i1, i2) => [i1, i2]; } else { Linqer._ensureFunction(zipper); } const self = this; Linqer._ensureInternalTryGetAt(this); // generator uses a buffer to hold all the items within the offset interval const gen = function* () { const buffer = Array(offset); let index = 0; for (const item of self) { const index2 = index - offset; if (index2 >= 0) { const item2 = buffer[index2 % offset]; yield zipper(item2, item); } buffer[index % offset] = item; index++; } for (let i = 0; i < offset; i++) { const item = buffer[(index + i) % offset]; yield zipper(item, undefined); } }; const result = new Linqer.Enumerable(gen); // count is the same as of the original enumerable result._count = () => { const count = self.count(); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible only if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index) => { const val1 = self._tryGetAt(index); const val2 = self._tryGetAt(index + offset); if (val1) { return { value: zipper(val1.value, val2 ? val2.value : undefined) }; } return null; }; } return result; }; /// returns an enumerable of at least minLength, padding the end with a value or the result of a function Linqer.Enumerable.prototype.padEnd = function (minLength, filler) { if (minLength <= 0) { throw new Error('minLength has to be positive.'); } let fillerFunc; if (typeof filler !== 'function') { fillerFunc = (index) => filler; } else { fillerFunc = filler; } const self = this; Linqer._ensureInternalTryGetAt(this); // generator iterates all elements, // then yields the result of the filler function until minLength items const gen = function* () { let index = 0; for (const item of self) { yield item; index++; } for (; index < minLength; index++) { yield fillerFunc(index); } }; const result = new Linqer.Enumerable(gen); // count is the maximum between minLength and the original count result._count = () => { const count = Math.max(minLength, self.count()); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index) => { const val = self._tryGetAt(index); if (val) return val; if (index < minLength) { return { value: fillerFunc(index) }; } return null; }; } return result; }; /// returns an enumerable of at least minLength, padding the start with a value or the result of a function /// if the enumerable cannot seek, then it will be iterated minLength time Linqer.Enumerable.prototype.padStart = function (minLength, filler) { if (minLength <= 0) { throw new Error('minLength has to be positive.'); } let fillerFunc; if (typeof filler !== 'function') { fillerFunc = (index) => filler; } else { fillerFunc = filler; } const self = this; Linqer._ensureInternalTryGetAt(self); // generator needs a buffer to hold offset values // it yields values from the buffer when it overflows // or filler function results if the buffer is not full // after iterating the entire original enumerable const gen = function* () { const buffer = Array(minLength); let index = 0; const iterator = self[Symbol.iterator](); let flushed = false; let done = false; do { const val = iterator.next(); done = !!val.done; if (!done) { buffer[index] = val.value; index++; } if (flushed && !done) { yield val.value; } else { if (done || index === minLength) { for (let i = 0; i < minLength - index; i++) { yield fillerFunc(i); } for (let i = 0; i < index; i++) { yield buffer[i]; } flushed = true; } } } while (!done); }; const result = new Linqer.Enumerable(gen); // count is the max of minLength and the original count result._count = () => { const count = Math.max(minLength, self.count()); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible only if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index) => { const count = self.count(); const delta = minLength - count; if (delta <= 0) { return self._tryGetAt(index); } if (index < delta) { return { value: fillerFunc(index) }; } return self._tryGetAt(index - delta); }; } return result; }; })(Linqer || (Linqer = {})); //# sourceMappingURL=LInQer.extra.js.map ================================================ FILE: LInQer.extra.ts ================================================ /// /// /// namespace Linqer { export interface Enumerable extends Iterable { /** * Returns a randomized sequence of items from an initial source * @returns shuffle */ shuffle(): Enumerable; /** * implements random reservoir sampling of k items, with the option to specify a maximum limit for the items * @param k * @param limit * @returns sample */ randomSample(k: number, limit: number): Enumerable; /** * Returns the count of the items in a sequence. Depending on the sequence type this iterates through it or not. * @returns count */ count(): number; /** * returns the distinct values based on a hashing function * * @param {ISelector} hashFunc * @returns {Enumerable} * @memberof Enumerable */ distinctByHash(hashFunc: ISelector): Enumerable; /** * returns the values that have different hashes from the items of the iterable provided * * @param {IterableType} iterable * @param {ISelector} hashFunc * @returns {Enumerable} * @memberof Enumerable */ exceptByHash(iterable: IterableType, hashFunc: ISelector): Enumerable; /** * returns the values that have the same hashes as items of the iterable provided * * @param {IterableType} iterable * @param {ISelector} hashFunc * @returns {Enumerable} * @memberof Enumerable */ intersectByHash(iterable: IterableType, hashFunc: ISelector): Enumerable; /** * returns the index of a value in an ordered enumerable or false if not found * WARNING: use the same comparer as the one used to order the enumerable. The algorithm assumes the enumerable is already sorted. * * @param {*} value * @param {IComparer} comparer * @returns {(number | boolean)} * @memberof Enumerable */ binarySearch(value: any, comparer: IComparer): number | boolean; /** * joins each item of the enumerable with previous items from the same enumerable * @param offset * @param zipper * @returns lag */ lag(offset: number, zipper: (item1: any, item2: any) => any): Enumerable; /** * joins each item of the enumerable with next items from the same enumerable * * @param {number} offset * @param {(item1: any, item2: any) => any} zipper * @returns {Enumerable} * @memberof Enumerable */ lead(offset: number, zipper: (item1: any, item2: any) => any): Enumerable; /** * returns an enumerable of at least minLength, padding the end with a value or the result of a function * * @param {number} minLength * @param {(any | ((index: number) => any))} filler * @returns {Enumerable} * @memberof Enumerable */ padEnd(minLength: number, filler: any | ((index: number) => any)): Enumerable; /** * returns an enumerable of at least minLength, padding the start with a value or the result of a function * if the enumerable cannot seek, then it will be iterated minLength time * * @param {number} minLength * @param {(any | ((index: number) => any))} filler * @returns {Enumerable} * @memberof Enumerable */ padStart(minLength: number, filler: any | ((index: number) => any)): Enumerable; } /// randomizes the enumerable (partial Fisher-Yates) Enumerable.prototype.shuffle = function (): Enumerable { const self = this; function* gen() { const arr = self.toArray(); const len = arr.length; let n = 0; while (n < len) { let k = n + Math.floor(Math.random() * (len - n)); const value = arr[k]; arr[k] = arr[n]; arr[n] = value; n++; yield value; } } const result = Enumerable.from(gen); result._count = () => self.count(); return result; }; /// implements random reservoir sampling of k items, with the option to specify a maximum limit for the items Enumerable.prototype.randomSample = function (k: number, limit: number = Number.MAX_SAFE_INTEGER): Enumerable { let index = 0; const sample = []; _ensureInternalTryGetAt(this); if (this._canSeek) { // L algorithm const length = this.count(); let index = 0; for (index = 0; index < k && index < limit && index < length; index++) { sample.push(this.elementAt(index)); } let W = Math.exp(Math.log(Math.random()) / k); while (index < length && index < limit) { index += Math.floor(Math.log(Math.random()) / Math.log(1 - W)) + 1; if (index < length && index < limit) { sample[Math.floor(Math.random() * k)] = this.elementAt(index); W *= Math.exp(Math.log(Math.random()) / k); } } } else { // R algorithm for (const item of this) { if (index < k) { sample.push(item); } else { const j = Math.floor(Math.random() * index); if (j < k) { sample[j] = item; } } index++; if (index >= limit) break; } } return Enumerable.from(sample); } /// returns the distinct values based on a hashing function Enumerable.prototype.distinctByHash = function (hashFunc: ISelector): Enumerable { // this is much more performant than distinct with a custom comparer const self = this; const gen = function* () { const distinctValues = new Set(); for (const item of self) { const size = distinctValues.size; distinctValues.add(hashFunc(item)); if (size < distinctValues.size) { yield item; } } }; return new Enumerable(gen); }; /// returns the values that have different hashes from the items of the iterable provided Enumerable.prototype.exceptByHash = function (iterable: IterableType, hashFunc: ISelector): Enumerable { // this is much more performant than except with a custom comparer _ensureIterable(iterable); const self = this; const gen = function* () { const distinctValues = Enumerable.from(iterable).select(hashFunc).toSet(); for (const item of self) { if (!distinctValues.has(hashFunc(item))) { yield item; } } }; return new Enumerable(gen); }; /// returns the values that have the same hashes as items of the iterable provided Enumerable.prototype.intersectByHash = function (iterable: IterableType, hashFunc: ISelector): Enumerable { // this is much more performant than intersect with a custom comparer _ensureIterable(iterable); const self = this; const gen = function* () { const distinctValues = Enumerable.from(iterable).select(hashFunc).toSet(); for (const item of self) { if (distinctValues.has(hashFunc(item))) { yield item; } } }; return new Enumerable(gen); }; /// returns the index of a value in an ordered enumerable or false if not found /// WARNING: use the same comparer as the one used in the ordered enumerable. The algorithm assumes the enumerable is already sorted. Enumerable.prototype.binarySearch = function (value: any, comparer: IComparer = _defaultComparer): number | boolean { let enumerable: Enumerable = this.toList(); let start = 0; let end = enumerable.count() - 1; while (start <= end) { const mid = (start + end) >> 1; const comp = comparer(enumerable.elementAt(mid), value); if (comp == 0) return mid; if (comp < 0) { start = mid + 1; } else { end = mid - 1; } } return false; }; /// joins each item of the enumerable with previous items from the same enumerable Enumerable.prototype.lag = function (offset: number, zipper: (item1: any, item2: any) => any): Enumerable { if (!offset) { throw new Error('offset has to be positive'); } if (offset < 0) { throw new Error('offset has to be positive. Use .lead if you want to join with next items'); } if (!zipper) { zipper = (i1, i2) => [i1, i2]; } else { _ensureFunction(zipper); } const self = this; _ensureInternalTryGetAt(this); // generator uses a buffer to hold all the items within the offset interval const gen = function* () { const buffer = Array(offset); let index = 0; for (const item of self) { const index2 = index - offset; const item2 = index2 < 0 ? undefined : buffer[index2 % offset]; yield zipper(item, item2); buffer[index % offset] = item; index++; } }; const result = new Enumerable(gen); // count is the same as of the original enumerable result._count = () => { const count = self.count(); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible only if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index: number) => { const val1 = self._tryGetAt!(index); const val2 = self._tryGetAt!(index - offset); if (val1) { return { value: zipper( val1.value, val2 ? val2.value : undefined ) }; } return null; }; } return result; } /// joins each item of the enumerable with next items from the same enumerable Enumerable.prototype.lead = function (offset: number, zipper: (item1: any, item2: any) => any): Enumerable { if (!offset) { throw new Error('offset has to be positive'); } if (offset < 0) { throw new Error('offset has to be positive. Use .lag if you want to join with previous items'); } if (!zipper) { zipper = (i1, i2) => [i1, i2]; } else { _ensureFunction(zipper); } const self = this; _ensureInternalTryGetAt(this); // generator uses a buffer to hold all the items within the offset interval const gen = function* () { const buffer = Array(offset); let index = 0; for (const item of self) { const index2 = index - offset; if (index2 >= 0) { const item2 = buffer[index2 % offset]; yield zipper(item2, item); } buffer[index % offset] = item; index++; } for (let i = 0; i < offset; i++) { const item = buffer[(index + i) % offset]; yield zipper(item, undefined); } }; const result = new Enumerable(gen); // count is the same as of the original enumerable result._count = () => { const count = self.count(); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible only if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index: number) => { const val1 = self._tryGetAt!(index); const val2 = self._tryGetAt!(index + offset); if (val1) { return { value: zipper( val1.value, val2 ? val2.value : undefined ) }; } return null; }; } return result; } /// returns an enumerable of at least minLength, padding the end with a value or the result of a function Enumerable.prototype.padEnd = function (minLength: number, filler: any | ((index: number) => any)): Enumerable { if (minLength <= 0) { throw new Error('minLength has to be positive.'); } let fillerFunc: (index: number) => any; if (typeof filler !== 'function') { fillerFunc = (index: number) => filler; } else { fillerFunc = filler; } const self = this; _ensureInternalTryGetAt(this); // generator iterates all elements, // then yields the result of the filler function until minLength items const gen = function* () { let index = 0; for (const item of self) { yield item; index++; } for (; index < minLength; index++) { yield fillerFunc(index); } }; const result = new Enumerable(gen); // count is the maximum between minLength and the original count result._count = () => { const count = Math.max(minLength, self.count()); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index: number) => { const val = self._tryGetAt!(index); if (val) return val; if (index < minLength) { return { value: fillerFunc(index) }; } return null; }; } return result; } /// returns an enumerable of at least minLength, padding the start with a value or the result of a function /// if the enumerable cannot seek, then it will be iterated minLength time Enumerable.prototype.padStart = function (minLength: number, filler: any | ((index: number) => any)): Enumerable { if (minLength <= 0) { throw new Error('minLength has to be positive.'); } let fillerFunc: (index: number) => any; if (typeof filler !== 'function') { fillerFunc = (index: number) => filler; } else { fillerFunc = filler; } const self = this; _ensureInternalTryGetAt(self); // generator needs a buffer to hold offset values // it yields values from the buffer when it overflows // or filler function results if the buffer is not full // after iterating the entire original enumerable const gen = function* () { const buffer = Array(minLength); let index = 0; const iterator = self[Symbol.iterator](); let flushed = false; let done = false; do { const val = iterator.next(); done = !!val.done; if (!done) { buffer[index] = val.value; index++; } if (flushed && !done) { yield val.value; } else { if (done || index === minLength) { for (let i = 0; i < minLength - index; i++) { yield fillerFunc(i); } for (let i = 0; i < index; i++) { yield buffer[i]; } flushed = true; } } } while (!done); }; const result = new Enumerable(gen); // count is the max of minLength and the original count result._count = () => { const count = Math.max(minLength, self.count()); if (!result._wasIterated) result._wasIterated = self._wasIterated; return count; }; // seeking is possible only if the original was seekable if (self._canSeek) { result._canSeek = true; result._tryGetAt = (index: number) => { const count = self.count(); const delta = minLength-count; if (delta<=0) { return self._tryGetAt!(index); } if (index} * @implements {IUsesQuickSort} */ class Enumerable { /** * You should never use this. Instead use Enumerable.from * @param {IterableType} src * @memberof Enumerable */ constructor(src) { _ensureIterable(src); this._src = src; const iteratorFunction = src[Symbol.iterator]; // the generator is either the iterator of the source enumerable // or the generator function that was provided as the source itself if (iteratorFunction) { this._generator = iteratorFunction.bind(src); } else { this._generator = src; } // set sorting method on an enumerable and all the derived ones should inherit it // TODO: a better method of doing this this._useQuickSort = src._useQuickSort !== undefined ? src._useQuickSort : true; this._canSeek = false; this._count = null; this._tryGetAt = null; this._wasIterated = false; } /** * Wraps an iterable item into an Enumerable if it's not already one * * @static * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ static from(iterable) { if (iterable instanceof Enumerable) return iterable; return new Enumerable(iterable); } /** * the Enumerable instance exposes the same iterator as the wrapped iterable or generator function * * @returns {Iterator} * @memberof Enumerable */ [Symbol.iterator]() { this._wasIterated = true; return this._generator(); } /** * returns an empty Enumerable * * @static * @returns {Enumerable} * @memberof Enumerable */ static empty() { const result = new Enumerable([]); result._count = () => 0; result._tryGetAt = (index) => null; result._canSeek = true; return result; } /** * generates a sequence of integer numbers within a specified range. * * @static * @param {number} start * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static range(start, count) { const gen = function* () { for (let i = 0; i < count; i++) { yield start + i; } }; const result = new Enumerable(gen); result._count = () => count; result._tryGetAt = index => { if (index >= 0 && index < count) return { value: start + index }; return null; }; result._canSeek = true; return result; } /** * Generates a sequence that contains one repeated value. * * @static * @param {*} item * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static repeat(item, count) { const gen = function* () { for (let i = 0; i < count; i++) { yield item; } }; const result = new Enumerable(gen); result._count = () => count; result._tryGetAt = index => { if (index >= 0 && index < count) return { value: item }; return null; }; result._canSeek = true; return result; } /** * Same value as count(), but will throw an Error if enumerable is not seekable and has to be iterated to get the length */ get length() { _ensureInternalTryGetAt(this); if (!this._canSeek) throw new Error('Calling length on this enumerable will iterate it. Use count()'); return this.count(); } /** * Concatenates two sequences by appending iterable to the existing one. * * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ concat(iterable) { _ensureIterable(iterable); const self = this; // the generator will iterate the enumerable first, then the iterable that was given as a parameter // this will be able to seek if both the original and the iterable derived enumerable can seek // the indexing function will get items from the first and then second enumerable without iteration const gen = function* () { for (const item of self) { yield item; } for (const item of Enumerable.from(iterable)) { yield item; } }; const result = new Enumerable(gen); const other = Enumerable.from(iterable); result._count = () => self.count() + other.count(); _ensureInternalTryGetAt(this); _ensureInternalTryGetAt(other); result._canSeek = self._canSeek && other._canSeek; if (self._canSeek) { result._tryGetAt = index => { return self._tryGetAt(index) || other._tryGetAt(index - self.count()); }; } return result; } /** * Returns the number of elements in a sequence. * * @returns {number} * @memberof Enumerable */ count() { _ensureInternalCount(this); return this._count(); } /** * Returns distinct elements from a sequence. * WARNING: using a comparer makes this slower. Not specifying it uses a Set to determine distinctiveness. * * @param {IEqualityComparer} [equalityComparer=EqualityComparer.default] * @returns {Enumerable} * @memberof Enumerable */ distinct(equalityComparer = Linqer.EqualityComparer.default) { const self = this; // if the comparer function is not provided, a Set will be used to quickly determine distinctiveness const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const distinctValues = new Set(); for (const item of self) { const size = distinctValues.size; distinctValues.add(item); if (size < distinctValues.size) { yield item; } } } // otherwise values will be compared with previous values ( O(n^2) ) // use distinctByHash in Linqer.extra to use a hashing function ( O(n log n) ) : function* () { const values = []; for (const item of self) { let unique = true; for (let i = 0; i < values.length; i++) { if (equalityComparer(item, values[i])) { unique = false; break; } } if (unique) yield item; values.push(item); } }; return new Enumerable(gen); } /** * Returns the element at a specified index in a sequence. * * @param {number} index * @returns {*} * @memberof Enumerable */ elementAt(index) { _ensureInternalTryGetAt(this); const result = this._tryGetAt(index); if (!result) throw new Error('Index out of range'); return result.value; } /** * Returns the element at a specified index in a sequence or undefined if the index is out of range. * * @param {number} index * @returns {(any | undefined)} * @memberof Enumerable */ elementAtOrDefault(index) { _ensureInternalTryGetAt(this); const result = this._tryGetAt(index); if (!result) return undefined; return result.value; } /** * Returns the first element of a sequence. * * @returns {*} * @memberof Enumerable */ first() { return this.elementAt(0); } /** * Returns the first element of a sequence, or a default value if no element is found. * * @returns {(any | undefined)} * @memberof Enumerable */ firstOrDefault() { return this.elementAtOrDefault(0); } /** * Returns the last element of a sequence. * * @returns {*} * @memberof Enumerable */ last() { _ensureInternalTryGetAt(this); // if this cannot seek, getting the last element requires iterating the whole thing if (!this._canSeek) { let result = null; let found = false; for (const item of this) { result = item; found = true; } if (found) return result; throw new Error('The enumeration is empty'); } // if this can seek, then just go directly at the last element const count = this.count(); return this.elementAt(count - 1); } /** * Returns the last element of a sequence, or undefined if no element is found. * * @returns {(any | undefined)} * @memberof Enumerable */ lastOrDefault() { _ensureInternalTryGetAt(this); if (!this._canSeek) { let result = undefined; for (const item of this) { result = item; } return result; } const count = this.count(); return this.elementAtOrDefault(count - 1); } /** * Returns the count, minimum and maximum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {{ count: number, min: any, max: any }} * @memberof Enumerable */ stats(comparer) { if (comparer) { _ensureFunction(comparer); } else { comparer = Linqer._defaultComparer; } const agg = { count: 0, min: undefined, max: undefined }; for (const item of this) { if (typeof agg.min === 'undefined' || comparer(item, agg.min) < 0) agg.min = item; if (typeof agg.max === 'undefined' || comparer(item, agg.max) > 0) agg.max = item; agg.count++; } return agg; } /** * Returns the minimum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ min(comparer) { const stats = this.stats(comparer); return stats.count === 0 ? undefined : stats.min; } /** * Returns the maximum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ max(comparer) { const stats = this.stats(comparer); return stats.count === 0 ? undefined : stats.max; } /** * Projects each element of a sequence into a new form. * * @param {ISelector} selector * @returns {Enumerable} * @memberof Enumerable */ select(selector) { _ensureFunction(selector); const self = this; // the generator is applying the selector on all the items of the enumerable // the count of the resulting enumerable is the same as the original's // the indexer is the same as that of the original, with the selector applied on the value const gen = function* () { let index = 0; for (const item of self) { yield selector(item, index); index++; } }; const result = new Enumerable(gen); _ensureInternalCount(this); result._count = this._count; _ensureInternalTryGetAt(self); result._canSeek = self._canSeek; result._tryGetAt = index => { const res = self._tryGetAt(index); if (!res) return res; return { value: selector(res.value) }; }; return result; } /** * Bypasses a specified number of elements in a sequence and then returns the remaining elements. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ skip(nr) { const self = this; // the generator just enumerates the first nr numbers then starts yielding values // the count is the same as the original enumerable, minus the skipped items and at least 0 // the indexer is the same as for the original, with an offset const gen = function* () { let nrLeft = nr; for (const item of self) { if (nrLeft > 0) { nrLeft--; } else { yield item; } } }; const result = new Enumerable(gen); result._count = () => Math.max(0, self.count() - nr); _ensureInternalTryGetAt(this); result._canSeek = this._canSeek; result._tryGetAt = index => self._tryGetAt(index + nr); return result; } /** * Takes start elements, ignores howmany elements, continues with the new items and continues with the original enumerable * Equivalent to the value of an array after performing splice on it with the same parameters * @param start * @param howmany * @param items * @returns splice */ splice(start, howmany, ...newItems) { // tried to define length and splice so that this is seen as an Array-like object, // but it doesn't work on properties. length needs to be a field. return this.take(start).concat(newItems).concat(this.skip(start + howmany)); } /** * Computes the sum of a sequence of numeric values. * * @returns {(number | undefined)} * @memberof Enumerable */ sum() { const stats = this.sumAndCount(); return stats.count === 0 ? undefined : stats.sum; } /** * Computes the sum and count of a sequence of numeric values. * * @returns {{ sum: number, count: number }} * @memberof Enumerable */ sumAndCount() { const agg = { count: 0, sum: 0 }; for (const item of this) { agg.sum = agg.count === 0 ? _toNumber(item) : agg.sum + _toNumber(item); agg.count++; } return agg; } /** * Returns a specified number of contiguous elements from the start of a sequence. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ take(nr) { const self = this; // the generator will stop after nr items yielded // the count is the maximum between the total count and nr // the indexer is the same, as long as it's not higher than nr const gen = function* () { let nrLeft = nr; for (const item of self) { if (nrLeft > 0) { yield item; nrLeft--; } if (nrLeft <= 0) { break; } } }; const result = new Enumerable(gen); result._count = () => Math.min(nr, self.count()); _ensureInternalTryGetAt(this); result._canSeek = self._canSeek; if (self._canSeek) { result._tryGetAt = index => { if (index >= nr) return null; return self._tryGetAt(index); }; } return result; } /** * creates an array from an Enumerable * * @returns {any[]} * @memberof Enumerable */ toArray() { var _a; _ensureInternalTryGetAt(this); // this should be faster than Array.from(this) if (this._canSeek) { const arr = new Array(this.count()); for (let i = 0; i < arr.length; i++) { arr[i] = (_a = this._tryGetAt(i)) === null || _a === void 0 ? void 0 : _a.value; } return arr; } // try to optimize the array growth by increasing it // by 64 every time it is needed const minIncrease = 64; let size = 0; const arr = []; for (const item of this) { if (size === arr.length) { arr.length += minIncrease; } arr[size] = item; size++; } arr.length = size; return arr; } /** * similar to toArray, but returns a seekable Enumerable (itself if already seekable) that can do count and elementAt without iterating * * @returns {Enumerable} * @memberof Enumerable */ toList() { _ensureInternalTryGetAt(this); if (this._canSeek) return this; return Enumerable.from(this.toArray()); } /** * Filters a sequence of values based on a predicate. * * @param {IFilter} condition * @returns {Enumerable} * @memberof Enumerable */ where(condition) { _ensureFunction(condition); const self = this; // cannot imply the count or indexer from the condition // where will have to iterate through the whole thing const gen = function* () { let index = 0; for (const item of self) { if (condition(item, index)) { yield item; } index++; } }; return new Enumerable(gen); } } Linqer.Enumerable = Enumerable; // throw if src is not a generator function or an iteratable function _ensureIterable(src) { if (src) { if (src[Symbol.iterator]) return; if (typeof src === 'function' && src.constructor.name === 'GeneratorFunction') return; } throw new Error('the argument must be iterable!'); } Linqer._ensureIterable = _ensureIterable; // throw if f is not a function function _ensureFunction(f) { if (!f || typeof f !== 'function') throw new Error('the argument needs to be a function!'); } Linqer._ensureFunction = _ensureFunction; // return Nan if this is not a number // different from Number(obj), which would cast strings to numbers function _toNumber(obj) { return typeof obj === 'number' ? obj : Number.NaN; } // return the iterable if already an array or use Array.from to create one function _toArray(iterable) { if (!iterable) return []; if (Array.isArray(iterable)) return iterable; return Array.from(iterable); } Linqer._toArray = _toArray; // if the internal count function is not defined, set it to the most appropriate one function _ensureInternalCount(enumerable) { if (enumerable._count) return; if (enumerable._src instanceof Enumerable) { // the count is the same as the underlying enumerable const innerEnumerable = enumerable._src; _ensureInternalCount(innerEnumerable); enumerable._count = () => innerEnumerable._count(); return; } const src = enumerable._src; // this could cause false positives, but if it has a numeric length or size, use it if (typeof src !== 'function' && typeof src.length === 'number') { enumerable._count = () => src.length; return; } if (typeof src.size === 'number') { enumerable._count = () => src.size; return; } // otherwise iterate the whole thing and count all items enumerable._count = () => { let x = 0; for (const item of enumerable) x++; return x; }; } Linqer._ensureInternalCount = _ensureInternalCount; // ensure there is an internal indexer function adequate for this enumerable // this also determines if the enumerable can seek function _ensureInternalTryGetAt(enumerable) { if (enumerable._tryGetAt) return; enumerable._canSeek = true; if (enumerable._src instanceof Enumerable) { // indexer and seekability is the same as for the underlying enumerable const innerEnumerable = enumerable._src; _ensureInternalTryGetAt(innerEnumerable); enumerable._tryGetAt = index => innerEnumerable._tryGetAt(index); enumerable._canSeek = innerEnumerable._canSeek; return; } if (typeof enumerable._src === 'string') { // a string can be accessed by index enumerable._tryGetAt = index => { if (index < enumerable._src.length) { return { value: enumerable._src.charAt(index) }; } return null; }; return; } if (Array.isArray(enumerable._src)) { // an array can be accessed by index enumerable._tryGetAt = index => { if (index >= 0 && index < enumerable._src.length) { return { value: enumerable._src[index] }; } return null; }; return; } const src = enumerable._src; if (typeof enumerable._src !== 'function' && typeof src.length === 'number') { // try to access an object with a defined numeric length by indexing it // might cause false positives enumerable._tryGetAt = index => { if (index < src.length && typeof src[index] !== 'undefined') { return { value: src[index] }; } return null; }; return; } enumerable._canSeek = false; // TODO other specialized types? objects, maps, sets? enumerable._tryGetAt = index => { let x = 0; for (const item of enumerable) { if (index === x) return { value: item }; x++; } return null; }; } Linqer._ensureInternalTryGetAt = _ensureInternalTryGetAt; /** * The default comparer function between two items * @param item1 * @param item2 */ Linqer._defaultComparer = (item1, item2) => { if (item1 > item2) return 1; if (item1 < item2) return -1; return 0; }; /** * Predefined equality comparers * default is the equivalent of == * exact is the equivalent of === */ Linqer.EqualityComparer = { default: (item1, item2) => item1 == item2, exact: (item1, item2) => item1 === item2, }; })(Linqer || (Linqer = {})); /// var Linqer; /// (function (Linqer) { /// Applies an accumulator function over a sequence. /// The specified seed value is used as the initial accumulator value, and the specified function is used to select the result value. Linqer.Enumerable.prototype.aggregate = function (accumulator, aggregator) { Linqer._ensureFunction(aggregator); for (const item of this) { accumulator = aggregator(accumulator, item); } return accumulator; }; /// Determines whether all elements of a sequence satisfy a condition. Linqer.Enumerable.prototype.all = function (condition) { Linqer._ensureFunction(condition); return !this.any(x => !condition(x)); }; /// Determines whether any element of a sequence exists or satisfies a condition. Linqer.Enumerable.prototype.any = function (condition) { Linqer._ensureFunction(condition); let index = 0; for (const item of this) { if (condition(item, index)) return true; index++; } return false; }; /// Appends a value to the end of the sequence. Linqer.Enumerable.prototype.append = function (item) { return this.concat([item]); }; /// Computes the average of a sequence of numeric values. Linqer.Enumerable.prototype.average = function () { const stats = this.sumAndCount(); return stats.count === 0 ? undefined : stats.sum / stats.count; }; /// Returns the same enumerable Linqer.Enumerable.prototype.asEnumerable = function () { return this; }; /// Checks the elements of a sequence based on their type /// If type is a string, it will check based on typeof, else it will use instanceof. /// Throws if types are different. Linqer.Enumerable.prototype.cast = function (type) { const f = typeof type === 'string' ? x => typeof x === type : x => x instanceof type; return this.select(item => { if (!f(item)) throw new Error(item + ' not of type ' + type); return item; }); }; /// Determines whether a sequence contains a specified element. /// A custom function can be used to determine equality between elements. Linqer.Enumerable.prototype.contains = function (item, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureFunction(equalityComparer); return this.any(x => equalityComparer(x, item)); }; Linqer.Enumerable.prototype.defaultIfEmpty = function () { throw new Error('defaultIfEmpty not implemented for Javascript'); }; /// Produces the set difference of two sequences WARNING: using the comparer is slower Linqer.Enumerable.prototype.except = function (iterable, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureIterable(iterable); const self = this; // use a Set for performance if the comparer is not set const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const distinctValues = Linqer.Enumerable.from(iterable).toSet(); for (const item of self) { if (!distinctValues.has(item)) yield item; } } // use exceptByHash from Linqer.extra for better performance : function* () { const values = Linqer._toArray(iterable); for (const item of self) { let unique = true; for (let i = 0; i < values.length; i++) { if (equalityComparer(item, values[i])) { unique = false; break; } } if (unique) yield item; } }; return new Linqer.Enumerable(gen); }; /// Produces the set intersection of two sequences. WARNING: using a comparer is slower Linqer.Enumerable.prototype.intersect = function (iterable, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureIterable(iterable); const self = this; // use a Set for performance if the comparer is not set const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const distinctValues = new Set(Linqer.Enumerable.from(iterable)); for (const item of self) { if (distinctValues.has(item)) yield item; } } // use intersectByHash from Linqer.extra for better performance : function* () { const values = Linqer._toArray(iterable); for (const item of self) { let unique = true; for (let i = 0; i < values.length; i++) { if (equalityComparer(item, values[i])) { unique = false; break; } } if (!unique) yield item; } }; return new Linqer.Enumerable(gen); }; /// same as count Linqer.Enumerable.prototype.longCount = function () { return this.count(); }; /// Filters the elements of a sequence based on their type /// If type is a string, it will filter based on typeof, else it will use instanceof Linqer.Enumerable.prototype.ofType = function (type) { const condition = typeof type === 'string' ? x => typeof x === type : x => x instanceof type; return this.where(condition); }; /// Adds a value to the beginning of the sequence. Linqer.Enumerable.prototype.prepend = function (item) { return new Linqer.Enumerable([item]).concat(this); }; /// Inverts the order of the elements in a sequence. Linqer.Enumerable.prototype.reverse = function () { Linqer._ensureInternalTryGetAt(this); const self = this; // if it can seek, just read the enumerable backwards const gen = this._canSeek ? function* () { const length = self.count(); for (let index = length - 1; index >= 0; index--) { yield self.elementAt(index); } } // else enumerate it all into an array, then read it backwards : function* () { const arr = self.toArray(); for (let index = arr.length - 1; index >= 0; index--) { yield arr[index]; } }; // the count is the same when reversed const result = new Linqer.Enumerable(gen); Linqer._ensureInternalCount(this); result._count = this._count; Linqer._ensureInternalTryGetAt(this); // have a custom indexer only if the original enumerable could seek if (this._canSeek) { const self = this; result._canSeek = true; result._tryGetAt = index => self._tryGetAt(self.count() - index - 1); } return result; }; /// Projects each element of a sequence to an iterable and flattens the resulting sequences into one sequence. Linqer.Enumerable.prototype.selectMany = function (selector) { if (typeof selector !== 'undefined') { Linqer._ensureFunction(selector); } else { selector = x => x; } const self = this; const gen = function* () { let index = 0; for (const item of self) { const iter = selector(item, index); Linqer._ensureIterable(iter); for (const child of iter) { yield child; } index++; } }; return new Linqer.Enumerable(gen); }; /// Determines whether two sequences are equal and in the same order according to an equality comparer. Linqer.Enumerable.prototype.sequenceEqual = function (iterable, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureIterable(iterable); Linqer._ensureFunction(equalityComparer); const iterator1 = this[Symbol.iterator](); const iterator2 = Linqer.Enumerable.from(iterable)[Symbol.iterator](); let done = false; do { const val1 = iterator1.next(); const val2 = iterator2.next(); const equal = (val1.done && val2.done) || (!val1.done && !val2.done && equalityComparer(val1.value, val2.value)); if (!equal) return false; done = !!val1.done; } while (!done); return true; }; /// Returns the single element of a sequence and throws if it doesn't have exactly one Linqer.Enumerable.prototype.single = function () { const iterator = this[Symbol.iterator](); let val = iterator.next(); if (val.done) throw new Error('Sequence contains no elements'); const result = val.value; val = iterator.next(); if (!val.done) throw new Error('Sequence contains more than one element'); return result; }; /// Returns the single element of a sequence or undefined if none found. It throws if the sequence contains multiple items. Linqer.Enumerable.prototype.singleOrDefault = function () { const iterator = this[Symbol.iterator](); let val = iterator.next(); if (val.done) return undefined; const result = val.value; val = iterator.next(); if (!val.done) throw new Error('Sequence contains more than one element'); return result; }; /// Selects the elements starting at the given start argument, and ends at, but does not include, the given end argument. Linqer.Enumerable.prototype.slice = function (start = 0, end) { let enumerable = this; // when the end is defined and positive and start is negative, // the only way to compute the last index is to know the count if (end !== undefined && end >= 0 && (start || 0) < 0) { enumerable = enumerable.toList(); start = enumerable.count() + start; } if (start !== 0) { if (start > 0) { enumerable = enumerable.skip(start); } else { enumerable = enumerable.takeLast(-start); } } if (end !== undefined) { if (end >= 0) { enumerable = enumerable.take(end - start); } else { enumerable = enumerable.skipLast(-end); } } return enumerable; }; /// Returns a new enumerable collection that contains the elements from source with the last nr elements of the source collection omitted. Linqer.Enumerable.prototype.skipLast = function (nr) { const self = this; // the generator is using a buffer to cache nr values // and only yields the values that overflow from it const gen = function* () { let nrLeft = nr; const buffer = Array(nrLeft); let index = 0; let offset = 0; for (const item of self) { const value = buffer[index - offset]; buffer[index - offset] = item; index++; if (index - offset >= nrLeft) { offset += nrLeft; } if (index > nrLeft) { yield value; } } buffer.length = 0; }; const result = new Linqer.Enumerable(gen); // the count is the original count minus the skipped items and at least 0 result._count = () => Math.max(0, self.count() - nr); Linqer._ensureInternalTryGetAt(this); result._canSeek = this._canSeek; // it has an indexer only if the original enumerable can seek if (this._canSeek) { result._tryGetAt = index => { if (index >= result.count()) return null; return self._tryGetAt(index); }; } return result; }; /// Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. Linqer.Enumerable.prototype.skipWhile = function (condition) { Linqer._ensureFunction(condition); const self = this; let skip = true; const gen = function* () { let index = 0; for (const item of self) { if (skip && !condition(item, index)) { skip = false; } if (!skip) { yield item; } index++; } }; return new Linqer.Enumerable(gen); }; /// Returns a new enumerable collection that contains the last nr elements from source. Linqer.Enumerable.prototype.takeLast = function (nr) { Linqer._ensureInternalTryGetAt(this); const self = this; const gen = this._canSeek // taking the last items is easy if the enumerable can seek ? function* () { let nrLeft = nr; const length = self.count(); for (let index = length - nrLeft; index < length; index++) { yield self.elementAt(index); } } // else the generator uses a buffer to fill with values // and yields them after the entire thing has been iterated : function* () { let nrLeft = nr; let index = 0; const buffer = Array(nrLeft); for (const item of self) { buffer[index % nrLeft] = item; index++; } for (let i = 0; i < nrLeft && i < index; i++) { yield buffer[(index + i) % nrLeft]; } }; const result = new Linqer.Enumerable(gen); // the count is the minimum between nr and the enumerable count result._count = () => Math.min(nr, self.count()); result._canSeek = self._canSeek; // this can seek only if the original enumerable could seek if (self._canSeek) { result._tryGetAt = index => { if (index < 0 || index >= result.count()) return null; return self._tryGetAt(self.count() - nr + index); }; } return result; }; /// Returns elements from a sequence as long as a specified condition is true, and then skips the remaining elements. Linqer.Enumerable.prototype.takeWhile = function (condition) { Linqer._ensureFunction(condition); const self = this; const gen = function* () { let index = 0; for (const item of self) { if (condition(item, index)) { yield item; } else { break; } index++; } }; return new Linqer.Enumerable(gen); }; Linqer.Enumerable.prototype.toDictionary = function () { throw new Error('use toMap or toObject instead of toDictionary'); }; /// creates a map from an Enumerable Linqer.Enumerable.prototype.toMap = function (keySelector, valueSelector = x => x) { Linqer._ensureFunction(keySelector); Linqer._ensureFunction(valueSelector); const result = new Map(); let index = 0; for (const item of this) { result.set(keySelector(item, index), valueSelector(item, index)); index++; } return result; }; /// creates an object from an enumerable Linqer.Enumerable.prototype.toObject = function (keySelector, valueSelector = x => x) { Linqer._ensureFunction(keySelector); Linqer._ensureFunction(valueSelector); const result = {}; let index = 0; for (const item of this) { result[keySelector(item, index)] = valueSelector(item); index++; } return result; }; Linqer.Enumerable.prototype.toHashSet = function () { throw new Error('use toSet instead of toHashSet'); }; /// creates a set from an enumerable Linqer.Enumerable.prototype.toSet = function () { const result = new Set(); for (const item of this) { result.add(item); } return result; }; /// Produces the set union of two sequences. Linqer.Enumerable.prototype.union = function (iterable, equalityComparer = Linqer.EqualityComparer.default) { Linqer._ensureIterable(iterable); return this.concat(iterable).distinct(equalityComparer); }; /// Applies a specified function to the corresponding elements of two sequences, producing a sequence of the results. Linqer.Enumerable.prototype.zip = function (iterable, zipper) { Linqer._ensureIterable(iterable); if (!zipper) { zipper = (i1, i2) => [i1, i2]; } else { Linqer._ensureFunction(zipper); } const self = this; const gen = function* () { let index = 0; const iterator1 = self[Symbol.iterator](); const iterator2 = Linqer.Enumerable.from(iterable)[Symbol.iterator](); let done = false; do { const val1 = iterator1.next(); const val2 = iterator2.next(); done = !!(val1.done || val2.done); if (!done) { yield zipper(val1.value, val2.value, index); } index++; } while (!done); }; return new Linqer.Enumerable(gen); }; })(Linqer || (Linqer = {})); /// var Linqer; /// (function (Linqer) { /// Groups the elements of a sequence. Linqer.Enumerable.prototype.groupBy = function (keySelector) { Linqer._ensureFunction(keySelector); const self = this; const gen = function* () { const groupMap = new Map(); let index = 0; // iterate all items and group them in a Map for (const item of self) { const key = keySelector(item, index); const group = groupMap.get(key); if (group) { group.push(item); } else { groupMap.set(key, [item]); } index++; } // then yield a GroupEnumerable for each group for (const [key, items] of groupMap) { const group = new GroupEnumerable(items, key); yield group; } }; const result = new Linqer.Enumerable(gen); return result; }; /// Correlates the elements of two sequences based on key equality and groups the results. A specified equalityComparer is used to compare keys. /// WARNING: using the equality comparer will be slower Linqer.Enumerable.prototype.groupJoin = function (iterable, innerKeySelector, outerKeySelector, resultSelector, equalityComparer = Linqer.EqualityComparer.default) { const self = this; const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const lookup = new Linqer.Enumerable(iterable) .groupBy(outerKeySelector) .toMap(g => g.key, g => g); let index = 0; for (const innerItem of self) { const arr = Linqer._toArray(lookup.get(innerKeySelector(innerItem, index))); yield resultSelector(innerItem, arr); index++; } } : function* () { let innerIndex = 0; for (const innerItem of self) { const arr = []; let outerIndex = 0; for (const outerItem of Linqer.Enumerable.from(iterable)) { if (equalityComparer(innerKeySelector(innerItem, innerIndex), outerKeySelector(outerItem, outerIndex))) { arr.push(outerItem); } outerIndex++; } yield resultSelector(innerItem, arr); innerIndex++; } }; return new Linqer.Enumerable(gen); }; /// Correlates the elements of two sequences based on matching keys. /// WARNING: using the equality comparer will be slower Linqer.Enumerable.prototype.join = function (iterable, innerKeySelector, outerKeySelector, resultSelector, equalityComparer = Linqer.EqualityComparer.default) { const self = this; const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const lookup = new Linqer.Enumerable(iterable) .groupBy(outerKeySelector) .toMap(g => g.key, g => g); let index = 0; for (const innerItem of self) { const group = lookup.get(innerKeySelector(innerItem, index)); if (group) { for (const outerItem of group) { yield resultSelector(innerItem, outerItem); } } index++; } } : function* () { let innerIndex = 0; for (const innerItem of self) { let outerIndex = 0; for (const outerItem of Linqer.Enumerable.from(iterable)) { if (equalityComparer(innerKeySelector(innerItem, innerIndex), outerKeySelector(outerItem, outerIndex))) { yield resultSelector(innerItem, outerItem); } outerIndex++; } innerIndex++; } }; return new Linqer.Enumerable(gen); }; Linqer.Enumerable.prototype.toLookup = function () { throw new Error('use groupBy instead of toLookup'); }; /** * An Enumerable that also exposes a group key * * @export * @class GroupEnumerable * @extends {Enumerable} */ class GroupEnumerable extends Linqer.Enumerable { constructor(iterable, key) { super(iterable); this.key = key; } } Linqer.GroupEnumerable = GroupEnumerable; })(Linqer || (Linqer = {})); /// var Linqer; /// (function (Linqer) { /// Sorts the elements of a sequence in ascending order. Linqer.Enumerable.prototype.orderBy = function (keySelector) { if (keySelector) { Linqer._ensureFunction(keySelector); } else { keySelector = item => item; } return new OrderedEnumerable(this, keySelector, true); }; /// Sorts the elements of a sequence in descending order. Linqer.Enumerable.prototype.orderByDescending = function (keySelector) { if (keySelector) { Linqer._ensureFunction(keySelector); } else { keySelector = item => item; } return new OrderedEnumerable(this, keySelector, false); }; /// use QuickSort for ordering (default). Recommended when take, skip, takeLast, skipLast are used after orderBy Linqer.Enumerable.prototype.useQuickSort = function () { this._useQuickSort = true; return this; }; /// use the default browser sort implementation for ordering at all times Linqer.Enumerable.prototype.useBrowserSort = function () { this._useQuickSort = false; return this; }; //static sort: (arr: any[], comparer?: IComparer) => void; Linqer.Enumerable.sort = function (arr, comparer = Linqer._defaultComparer) { _quickSort(arr, 0, arr.length - 1, comparer, 0, Number.MAX_SAFE_INTEGER); return arr; }; let RestrictionType; (function (RestrictionType) { RestrictionType[RestrictionType["skip"] = 0] = "skip"; RestrictionType[RestrictionType["skipLast"] = 1] = "skipLast"; RestrictionType[RestrictionType["take"] = 2] = "take"; RestrictionType[RestrictionType["takeLast"] = 3] = "takeLast"; })(RestrictionType || (RestrictionType = {})); /** * An Enumerable yielding ordered items * * @export * @class OrderedEnumerable * @extends {Enumerable} */ class OrderedEnumerable extends Linqer.Enumerable { /** *Creates an instance of OrderedEnumerable. * @param {IterableType} src * @param {ISelector} [keySelector] * @param {boolean} [ascending=true] * @memberof OrderedEnumerable */ constructor(src, keySelector, ascending = true) { super(src); this._keySelectors = []; this._restrictions = []; if (keySelector) { this._keySelectors.push({ keySelector: keySelector, ascending: ascending }); } const self = this; // generator gets an array of the original, // sorted inside the interval determined by functions such as skip, take, skipLast, takeLast this._generator = function* () { let { startIndex, endIndex, arr } = this.getSortedArray(); if (arr) { for (let index = startIndex; index < endIndex; index++) { yield arr[index]; } } }; // the count is the difference between the end and start indexes // if no skip/take functions were used, this will be the original count this._count = () => { const totalCount = Linqer.Enumerable.from(self._src).count(); const { startIndex, endIndex } = this.getStartAndEndIndexes(self._restrictions, totalCount); return endIndex - startIndex; }; // an ordered enumerable cannot seek this._canSeek = false; this._tryGetAt = () => { throw new Error('Ordered enumerables cannot seek'); }; } getSortedArray() { const self = this; let startIndex; let endIndex; let arr = null; const innerEnumerable = self._src; Linqer._ensureInternalTryGetAt(innerEnumerable); // try to avoid enumerating the entire original into an array if (innerEnumerable._canSeek) { ({ startIndex, endIndex } = self.getStartAndEndIndexes(self._restrictions, innerEnumerable.count())); } else { arr = Array.from(self._src); ({ startIndex, endIndex } = self.getStartAndEndIndexes(self._restrictions, arr.length)); } if (startIndex < endIndex) { if (!arr) { arr = Array.from(self._src); } // only quicksort supports partial ordering inside an interval const sort = self._useQuickSort ? (a, c) => _quickSort(a, 0, a.length - 1, c, startIndex, endIndex) : (a, c) => a.sort(c); const sortFunc = self.generateSortFunc(self._keySelectors); sort(arr, sortFunc); return { startIndex, endIndex, arr }; } else { return { startIndex, endIndex, arr: null }; } } generateSortFunc(selectors) { // simplify the selectors into an array of comparers const comparers = selectors.map(s => { const f = s.keySelector; const comparer = (i1, i2) => { const k1 = f(i1); const k2 = f(i2); if (k1 > k2) return 1; if (k1 < k2) return -1; return 0; }; return s.ascending ? comparer : (i1, i2) => -comparer(i1, i2); }); // optimize the resulting sort function in the most common case // (ordered by a single criterion) return comparers.length == 1 ? comparers[0] : (i1, i2) => { for (let i = 0; i < comparers.length; i++) { const v = comparers[i](i1, i2); if (v) return v; } return 0; }; } /// calculate the interval in which an array needs to have ordered items for this ordered enumerable getStartAndEndIndexes(restrictions, arrLength) { let startIndex = 0; let endIndex = arrLength; for (const restriction of restrictions) { switch (restriction.type) { case RestrictionType.take: endIndex = Math.min(endIndex, startIndex + restriction.nr); break; case RestrictionType.skip: startIndex = Math.min(endIndex, startIndex + restriction.nr); break; case RestrictionType.takeLast: startIndex = Math.max(startIndex, endIndex - restriction.nr); break; case RestrictionType.skipLast: endIndex = Math.max(startIndex, endIndex - restriction.nr); break; } } return { startIndex, endIndex }; } /** * Performs a subsequent ordering of the elements in a sequence in ascending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ thenBy(keySelector) { this._keySelectors.push({ keySelector: keySelector, ascending: true }); return this; } /** * Performs a subsequent ordering of the elements in a sequence in descending order. * * @param {ISelector} keySelector * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ thenByDescending(keySelector) { this._keySelectors.push({ keySelector: keySelector, ascending: false }); return this; } /** * Deferred and optimized implementation of take * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ take(nr) { this._restrictions.push({ type: RestrictionType.take, nr: nr }); return this; } /** * Deferred and optimized implementation of takeLast * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ takeLast(nr) { this._restrictions.push({ type: RestrictionType.takeLast, nr: nr }); return this; } /** * Deferred and optimized implementation of skip * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ skip(nr) { this._restrictions.push({ type: RestrictionType.skip, nr: nr }); return this; } /** * Deferred and optimized implementation of skipLast * * @param {number} nr * @returns {OrderedEnumerable} * @memberof OrderedEnumerable */ skipLast(nr) { this._restrictions.push({ type: RestrictionType.skipLast, nr: nr }); return this; } /** * An optimized implementation of toArray * * @returns {any[]} * @memberof OrderedEnumerable */ toArray() { const { startIndex, endIndex, arr } = this.getSortedArray(); return arr ? arr.slice(startIndex, endIndex) : []; } /** * An optimized implementation of toMap * * @param {ISelector} keySelector * @param {ISelector} [valueSelector=x => x] * @returns {Map} * @memberof OrderedEnumerable */ toMap(keySelector, valueSelector = x => x) { Linqer._ensureFunction(keySelector); Linqer._ensureFunction(valueSelector); const result = new Map(); const arr = this.toArray(); for (let i = 0; i < arr.length; i++) { result.set(keySelector(arr[i], i), valueSelector(arr[i], i)); } return result; } /** * An optimized implementation of toObject * * @param {ISelector} keySelector * @param {ISelector} [valueSelector=x => x] * @returns {{ [key: string]: any }} * @memberof OrderedEnumerable */ toObject(keySelector, valueSelector = x => x) { Linqer._ensureFunction(keySelector); Linqer._ensureFunction(valueSelector); const result = {}; const arr = this.toArray(); for (let i = 0; i < arr.length; i++) { result[keySelector(arr[i], i)] = valueSelector(arr[i], i); } return result; } /** * An optimized implementation of to Set * * @returns {Set} * @memberof OrderedEnumerable */ toSet() { const result = new Set(); const arr = this.toArray(); for (let i = 0; i < arr.length; i++) { result.add(arr[i]); } return result; } } Linqer.OrderedEnumerable = OrderedEnumerable; const _insertionSortThreshold = 64; /// insertion sort is used for small intervals function _insertionsort(arr, leftIndex, rightIndex, comparer) { for (let j = leftIndex; j <= rightIndex; j++) { const key = arr[j]; let i = j - 1; while (i >= leftIndex && comparer(arr[i], key) > 0) { arr[i + 1] = arr[i]; i--; } arr[i + 1] = key; } } /// swap two items in an array by index function _swapArrayItems(array, leftIndex, rightIndex) { const temp = array[leftIndex]; array[leftIndex] = array[rightIndex]; array[rightIndex] = temp; } // Quicksort partition by center value coming from both sides function _partition(items, left, right, comparer) { const pivot = items[(right + left) >> 1]; while (left <= right) { while (comparer(items[left], pivot) < 0) { left++; } while (comparer(items[right], pivot) > 0) { right--; } if (left < right) { _swapArrayItems(items, left, right); left++; right--; } else { if (left === right) return left + 1; } } return left; } /// optimized Quicksort algorithm function _quickSort(items, left, right, comparer = Linqer._defaultComparer, minIndex = 0, maxIndex = Number.MAX_SAFE_INTEGER) { if (!items.length) return items; // store partition indexes to be processed in here const partitions = []; partitions.push({ left, right }); let size = 1; // the actual size of the partitions array never decreases // but we keep score of the number of partitions in 'size' // and we reuse slots whenever possible while (size) { const partition = { left, right } = partitions[size - 1]; if (right - left < _insertionSortThreshold) { _insertionsort(items, left, right, comparer); size--; continue; } const index = _partition(items, left, right, comparer); if (left < index - 1 && index - 1 >= minIndex) { partition.right = index - 1; if (index < right && index < maxIndex) { partitions[size] = { left: index, right }; size++; } } else { if (index < right && index < maxIndex) { partition.left = index; } else { size--; } } } return items; } })(Linqer || (Linqer = {})); // export to NPM if (typeof (module) !== 'undefined') { module.exports = Linqer; } //# sourceMappingURL=LInQer.js.map ================================================ FILE: LInQer.slim.js ================================================ "use strict"; var Linqer; (function (Linqer) { /** * wrapper class over iterable instances that exposes the methods usually found in .NET LINQ * * @export * @class Enumerable * @implements {Iterable} * @implements {IUsesQuickSort} */ class Enumerable { /** * You should never use this. Instead use Enumerable.from * @param {IterableType} src * @memberof Enumerable */ constructor(src) { _ensureIterable(src); this._src = src; const iteratorFunction = src[Symbol.iterator]; // the generator is either the iterator of the source enumerable // or the generator function that was provided as the source itself if (iteratorFunction) { this._generator = iteratorFunction.bind(src); } else { this._generator = src; } // set sorting method on an enumerable and all the derived ones should inherit it // TODO: a better method of doing this this._useQuickSort = src._useQuickSort !== undefined ? src._useQuickSort : true; this._canSeek = false; this._count = null; this._tryGetAt = null; this._wasIterated = false; } /** * Wraps an iterable item into an Enumerable if it's not already one * * @static * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ static from(iterable) { if (iterable instanceof Enumerable) return iterable; return new Enumerable(iterable); } /** * the Enumerable instance exposes the same iterator as the wrapped iterable or generator function * * @returns {Iterator} * @memberof Enumerable */ [Symbol.iterator]() { this._wasIterated = true; return this._generator(); } /** * returns an empty Enumerable * * @static * @returns {Enumerable} * @memberof Enumerable */ static empty() { const result = new Enumerable([]); result._count = () => 0; result._tryGetAt = (index) => null; result._canSeek = true; return result; } /** * generates a sequence of integer numbers within a specified range. * * @static * @param {number} start * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static range(start, count) { const gen = function* () { for (let i = 0; i < count; i++) { yield start + i; } }; const result = new Enumerable(gen); result._count = () => count; result._tryGetAt = index => { if (index >= 0 && index < count) return { value: start + index }; return null; }; result._canSeek = true; return result; } /** * Generates a sequence that contains one repeated value. * * @static * @param {*} item * @param {number} count * @returns {Enumerable} * @memberof Enumerable */ static repeat(item, count) { const gen = function* () { for (let i = 0; i < count; i++) { yield item; } }; const result = new Enumerable(gen); result._count = () => count; result._tryGetAt = index => { if (index >= 0 && index < count) return { value: item }; return null; }; result._canSeek = true; return result; } /** * Same value as count(), but will throw an Error if enumerable is not seekable and has to be iterated to get the length */ get length() { _ensureInternalTryGetAt(this); if (!this._canSeek) throw new Error('Calling length on this enumerable will iterate it. Use count()'); return this.count(); } /** * Concatenates two sequences by appending iterable to the existing one. * * @param {IterableType} iterable * @returns {Enumerable} * @memberof Enumerable */ concat(iterable) { _ensureIterable(iterable); const self = this; // the generator will iterate the enumerable first, then the iterable that was given as a parameter // this will be able to seek if both the original and the iterable derived enumerable can seek // the indexing function will get items from the first and then second enumerable without iteration const gen = function* () { for (const item of self) { yield item; } for (const item of Enumerable.from(iterable)) { yield item; } }; const result = new Enumerable(gen); const other = Enumerable.from(iterable); result._count = () => self.count() + other.count(); _ensureInternalTryGetAt(this); _ensureInternalTryGetAt(other); result._canSeek = self._canSeek && other._canSeek; if (self._canSeek) { result._tryGetAt = index => { return self._tryGetAt(index) || other._tryGetAt(index - self.count()); }; } return result; } /** * Returns the number of elements in a sequence. * * @returns {number} * @memberof Enumerable */ count() { _ensureInternalCount(this); return this._count(); } /** * Returns distinct elements from a sequence. * WARNING: using a comparer makes this slower. Not specifying it uses a Set to determine distinctiveness. * * @param {IEqualityComparer} [equalityComparer=EqualityComparer.default] * @returns {Enumerable} * @memberof Enumerable */ distinct(equalityComparer = Linqer.EqualityComparer.default) { const self = this; // if the comparer function is not provided, a Set will be used to quickly determine distinctiveness const gen = equalityComparer === Linqer.EqualityComparer.default ? function* () { const distinctValues = new Set(); for (const item of self) { const size = distinctValues.size; distinctValues.add(item); if (size < distinctValues.size) { yield item; } } } // otherwise values will be compared with previous values ( O(n^2) ) // use distinctByHash in Linqer.extra to use a hashing function ( O(n log n) ) : function* () { const values = []; for (const item of self) { let unique = true; for (let i = 0; i < values.length; i++) { if (equalityComparer(item, values[i])) { unique = false; break; } } if (unique) yield item; values.push(item); } }; return new Enumerable(gen); } /** * Returns the element at a specified index in a sequence. * * @param {number} index * @returns {*} * @memberof Enumerable */ elementAt(index) { _ensureInternalTryGetAt(this); const result = this._tryGetAt(index); if (!result) throw new Error('Index out of range'); return result.value; } /** * Returns the element at a specified index in a sequence or undefined if the index is out of range. * * @param {number} index * @returns {(any | undefined)} * @memberof Enumerable */ elementAtOrDefault(index) { _ensureInternalTryGetAt(this); const result = this._tryGetAt(index); if (!result) return undefined; return result.value; } /** * Returns the first element of a sequence. * * @returns {*} * @memberof Enumerable */ first() { return this.elementAt(0); } /** * Returns the first element of a sequence, or a default value if no element is found. * * @returns {(any | undefined)} * @memberof Enumerable */ firstOrDefault() { return this.elementAtOrDefault(0); } /** * Returns the last element of a sequence. * * @returns {*} * @memberof Enumerable */ last() { _ensureInternalTryGetAt(this); // if this cannot seek, getting the last element requires iterating the whole thing if (!this._canSeek) { let result = null; let found = false; for (const item of this) { result = item; found = true; } if (found) return result; throw new Error('The enumeration is empty'); } // if this can seek, then just go directly at the last element const count = this.count(); return this.elementAt(count - 1); } /** * Returns the last element of a sequence, or undefined if no element is found. * * @returns {(any | undefined)} * @memberof Enumerable */ lastOrDefault() { _ensureInternalTryGetAt(this); if (!this._canSeek) { let result = undefined; for (const item of this) { result = item; } return result; } const count = this.count(); return this.elementAtOrDefault(count - 1); } /** * Returns the count, minimum and maximum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {{ count: number, min: any, max: any }} * @memberof Enumerable */ stats(comparer) { if (comparer) { _ensureFunction(comparer); } else { comparer = Linqer._defaultComparer; } const agg = { count: 0, min: undefined, max: undefined }; for (const item of this) { if (typeof agg.min === 'undefined' || comparer(item, agg.min) < 0) agg.min = item; if (typeof agg.max === 'undefined' || comparer(item, agg.max) > 0) agg.max = item; agg.count++; } return agg; } /** * Returns the minimum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ min(comparer) { const stats = this.stats(comparer); return stats.count === 0 ? undefined : stats.min; } /** * Returns the maximum value in a sequence of values. * A custom function can be used to establish order (the result 0 means equal, 1 means larger, -1 means smaller) * * @param {IComparer} [comparer] * @returns {*} * @memberof Enumerable */ max(comparer) { const stats = this.stats(comparer); return stats.count === 0 ? undefined : stats.max; } /** * Projects each element of a sequence into a new form. * * @param {ISelector} selector * @returns {Enumerable} * @memberof Enumerable */ select(selector) { _ensureFunction(selector); const self = this; // the generator is applying the selector on all the items of the enumerable // the count of the resulting enumerable is the same as the original's // the indexer is the same as that of the original, with the selector applied on the value const gen = function* () { let index = 0; for (const item of self) { yield selector(item, index); index++; } }; const result = new Enumerable(gen); _ensureInternalCount(this); result._count = this._count; _ensureInternalTryGetAt(self); result._canSeek = self._canSeek; result._tryGetAt = index => { const res = self._tryGetAt(index); if (!res) return res; return { value: selector(res.value) }; }; return result; } /** * Bypasses a specified number of elements in a sequence and then returns the remaining elements. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ skip(nr) { const self = this; // the generator just enumerates the first nr numbers then starts yielding values // the count is the same as the original enumerable, minus the skipped items and at least 0 // the indexer is the same as for the original, with an offset const gen = function* () { let nrLeft = nr; for (const item of self) { if (nrLeft > 0) { nrLeft--; } else { yield item; } } }; const result = new Enumerable(gen); result._count = () => Math.max(0, self.count() - nr); _ensureInternalTryGetAt(this); result._canSeek = this._canSeek; result._tryGetAt = index => self._tryGetAt(index + nr); return result; } /** * Takes start elements, ignores howmany elements, continues with the new items and continues with the original enumerable * Equivalent to the value of an array after performing splice on it with the same parameters * @param start * @param howmany * @param items * @returns splice */ splice(start, howmany, ...newItems) { // tried to define length and splice so that this is seen as an Array-like object, // but it doesn't work on properties. length needs to be a field. return this.take(start).concat(newItems).concat(this.skip(start + howmany)); } /** * Computes the sum of a sequence of numeric values. * * @returns {(number | undefined)} * @memberof Enumerable */ sum() { const stats = this.sumAndCount(); return stats.count === 0 ? undefined : stats.sum; } /** * Computes the sum and count of a sequence of numeric values. * * @returns {{ sum: number, count: number }} * @memberof Enumerable */ sumAndCount() { const agg = { count: 0, sum: 0 }; for (const item of this) { agg.sum = agg.count === 0 ? _toNumber(item) : agg.sum + _toNumber(item); agg.count++; } return agg; } /** * Returns a specified number of contiguous elements from the start of a sequence. * * @param {number} nr * @returns {Enumerable} * @memberof Enumerable */ take(nr) { const self = this; // the generator will stop after nr items yielded // the count is the maximum between the total count and nr // the indexer is the same, as long as it's not higher than nr const gen = function* () { let nrLeft = nr; for (const item of self) { if (nrLeft > 0) { yield item; nrLeft--; } if (nrLeft <= 0) { break; } } }; const result = new Enumerable(gen); result._count = () => Math.min(nr, self.count()); _ensureInternalTryGetAt(this); result._canSeek = self._canSeek; if (self._canSeek) { result._tryGetAt = index => { if (index >= nr) return null; return self._tryGetAt(index); }; } return result; } /** * creates an array from an Enumerable * * @returns {any[]} * @memberof Enumerable */ toArray() { var _a; _ensureInternalTryGetAt(this); // this should be faster than Array.from(this) if (this._canSeek) { const arr = new Array(this.count()); for (let i = 0; i < arr.length; i++) { arr[i] = (_a = this._tryGetAt(i)) === null || _a === void 0 ? void 0 : _a.value; } return arr; } // try to optimize the array growth by increasing it // by 64 every time it is needed const minIncrease = 64; let size = 0; const arr = []; for (const item of this) { if (size === arr.length) { arr.length += minIncrease; } arr[size] = item; size++; } arr.length = size; return arr; } /** * similar to toArray, but returns a seekable Enumerable (itself if already seekable) that can do count and elementAt without iterating * * @returns {Enumerable} * @memberof Enumerable */ toList() { _ensureInternalTryGetAt(this); if (this._canSeek) return this; return Enumerable.from(this.toArray()); } /** * Filters a sequence of values based on a predicate. * * @param {IFilter} condition * @returns {Enumerable} * @memberof Enumerable */ where(condition) { _ensureFunction(condition); const self = this; // cannot imply the count or indexer from the condition // where will have to iterate through the whole thing const gen = function* () { let index = 0; for (const item of self) { if (condition(item, index)) { yield item; } index++; } }; return new Enumerable(gen); } } Linqer.Enumerable = Enumerable; // throw if src is not a generator function or an iteratable function _ensureIterable(src) { if (src) { if (src[Symbol.iterator]) return; if (typeof src === 'function' && src.constructor.name === 'GeneratorFunction') return; } throw new Error('the argument must be iterable!'); } Linqer._ensureIterable = _ensureIterable; // throw if f is not a function function _ensureFunction(f) { if (!f || typeof f !== 'function') throw new Error('the argument needs to be a function!'); } Linqer._ensureFunction = _ensureFunction; // return Nan if this is not a number // different from Number(obj), which would cast strings to numbers function _toNumber(obj) { return typeof obj === 'number' ? obj : Number.NaN; } // return the iterable if already an array or use Array.from to create one function _toArray(iterable) { if (!iterable) return []; if (Array.isArray(iterable)) return iterable; return Array.from(iterable); } Linqer._toArray = _toArray; // if the internal count function is not defined, set it to the most appropriate one function _ensureInternalCount(enumerable) { if (enumerable._count) return; if (enumerable._src instanceof Enumerable) { // the count is the same as the underlying enumerable const innerEnumerable = enumerable._src; _ensureInternalCount(innerEnumerable); enumerable._count = () => innerEnumerable._count(); return; } const src = enumerable._src; // this could cause false positives, but if it has a numeric length or size, use it if (typeof src !== 'function' && typeof src.length === 'number') { enumerable._count = () => src.length; return; } if (typeof src.size === 'number') { enumerable._count = () => src.size; return; } // otherwise iterate the whole thing and count all items enumerable._count = () => { let x = 0; for (const item of enumerable) x++; return x; }; } Linqer._ensureInternalCount = _ensureInternalCount; // ensure there is an internal indexer function adequate for this enumerable // this also determines if the enumerable can seek function _ensureInternalTryGetAt(enumerable) { if (enumerable._tryGetAt) return; enumerable._canSeek = true; if (enumerable._src instanceof Enumerable) { // indexer and seekability is the same as for the underlying enumerable const innerEnumerable = enumerable._src; _ensureInternalTryGetAt(innerEnumerable); enumerable._tryGetAt = index => innerEnumerable._tryGetAt(index); enumerable._canSeek = innerEnumerable._canSeek; return; } if (typeof enumerable._src === 'string') { // a string can be accessed by index enumerable._tryGetAt = index => { if (index < enumerable._src.length) { return { value: enumerable._src.charAt(index) }; } return null; }; return; } if (Array.isArray(enumerable._src)) { // an array can be accessed by index enumerable._tryGetAt = index => { if (index >= 0 && index < enumerable._src.length) { return { value: enumerable._src[index] }; } return null; }; return; } const src = enumerable._src; if (typeof enumerable._src !== 'function' && typeof src.length === 'number') { // try to access an object with a defined numeric length by indexing it // might cause false positives enumerable._tryGetAt = index => { if (index < src.length && typeof src[index] !== 'undefined') { return { value: src[index] }; } return null; }; return; } enumerable._canSeek = false; // TODO other specialized types? objects, maps, sets? enumerable._tryGetAt = index => { let x = 0; for (const item of enumerable) { if (index === x) return { value: item }; x++; } return null; }; } Linqer._ensureInternalTryGetAt = _ensureInternalTryGetAt; /** * The default comparer function between two items * @param item1 * @param item2 */ Linqer._defaultComparer = (item1, item2) => { if (item1 > item2) return 1; if (item1 < item2) return -1; return 0; }; /** * Predefined equality comparers * default is the equivalent of == * exact is the equivalent of === */ Linqer.EqualityComparer = { default: (item1, item2) => item1 == item2, exact: (item1, item2) => item1 === item2, }; })(Linqer || (Linqer = {})); //# sourceMappingURL=LInQer.Slim.js.map ================================================ FILE: README.md ================================================ MAJOR UPDATE: I've rewritten the entire thing into [linqer-ts](https://www.npmjs.com/package/@siderite/linqer-ts). Any improvements or updates will be on that project. # LInQer The C# Language Integrated Queries ported for Javascript for amazing performance [![npm version](https://badge.fury.io/js/%40siderite%2Flinqer.svg)](https://badge.fury.io/js/%40siderite%2Flinqer) [![License: MIT](https://img.shields.io/badge/Licence-MIT-blueviolet)](https://opensource.org/licenses/MIT) # Installation ```sh $ npm install @siderite/linqer ``` # Quick start ```sh const source = ... an array or a generator function or anything that is iterable... ; const enumerable = Linqer.Enumerable.from(source); // now you can both iterate and use LINQ like functions const result = enumerable .where(item=>!!item.value) // like filter .select(item=>{ value: item.value, key: item.name }) // like map .groupBy(item=>item.key) .where(g=>g.length>10) .orderBy(g=>g.key) .selectMany() .skip(15) .take(5); for (const item of result) ... ``` in Node.js you have to prepend: ``` const Linqer = require('@siderite/linqer'); ``` in Typescript, use the .ts files directly or install @types/node and use require, I guess. I couldn't make it work for both TS and JS. I will try to make that happen in version 2, which will probably have a different file layout. # Licence MIT Array functions in Javascript create a new array for each operation, which is terribly wasteful. Using iterators and generator functions and objects, we can limit the operations to the items in the array that interest us, not all of them. # Blog post https://siderite.dev/blog/linq-in-javascript-linqer. Leave comments there or add Issues on GitHub for feedback and support. # Hosted Find it hosted on GitHub Pages and use it freely in your projects at: - https://siderite.github.io/LInQer/LInQer.min.js - main library - https://siderite.github.io/LInQer/LInQer.slim.min.js - only basic functionality - https://siderite.github.io/LInQer/LInQer.extra.min.js - extra functionality (needs main Linqer) # Reference Reference **Linqer.slim.js** for the basic methods: - from, empty, range, repeat - static on Linqer.Enumerable - length property - same as count, but throws error if the enumerable needs to be enumerated to get the length (no side effects) - concat - count - distinct - elementAt and elementAtOrDefault - first and firstOrDefault - last and lastOrDefault - min, max, stats (min, max and count) - select - skip and take - splice function - kind of useless, but it was an experiment to see if I can make Enumerable appear as an Array-like object - sum and sumAndCount (sum and count) - toArray - toList - similar to toArray, but returns a seekable Enumerable (itself if already seekable) that can do *count* and *elementAt* without iterating - where Reference **Linqer.js** for all of the original Enumerable methods, the ones in slim and then the following: - aggregate - all - any - append - average - asEnumerable - cast - contains - defaultIfEmpty - throws not implemented - except - intersect - join - groupBy - groupJoin - longCount - ofType - orderBy - orderByDescending - prepend - reverse - selectMany - sequenceEqual - single - singleOrDefault - skip - on an ordered enumerable - skipLast - on a regular or ordered enumerable - skipWhile - slice - take - on an ordered enumerable - takeLast - on a regular or ordered enumerable - takeWhile - thenBy - on an ordered enumerable - thenByDescending - on an ordered enumerable - toDictionary - throws not implemented - toLookup - throws not implemented - toMap - toObject - toHashSet - throws not implemented - toSet - union - zip Reference **Linqer.extra.js** (needs **Linqer.js**) for some additional methods: - shuffle - randomizes the enumerable - randomSample - implements random reservoir sampling of k items - distinctByHash - distinct based on a hashing function, not a comparer - faster - exceptByHash - except based on a hashing function, not a comparer - faster - intersectByHash - intersect based on a hashing function, not a comparer - faster - binarySearch - find the index of a value in a sorted enumerable by binary search - lag - joins each item of the enumerable with previous items from the same enumerable - lead - joins each item of the enumerable with next items from the same enumerable - padStart - pad enumerable at the start to a minimum length - padEnd - pad enumerable at the end to a minimum length # Original *Enumerable* .NET class The original C# class can be found here: https://docs.microsoft.com/en-us/dotnet/api/system.linq.enumerable . # Building the solution The library has been ported to Typescript. Run **build.bat** to create the .js and .map files from the .ts code. ================================================ FILE: Release.txt ================================================ 2020-03-08 - 1.2.2 - made typings work for Visual Studio Code for Node.js 2020-02-16 - 1.2.1 - added comments to the code to better explain the mechanism - bugfix: canSeek was not set for reverse 2020-02-16 - 1.2.0 - bugfix: lead had the wrong indexing function for elementAt - bugfix: ordered enumerables mistakenly reported being able to seek (elementAt) - performance improvements for toArray, reverse, shuffle, binarySearch - performance improvements for orderBy and sort in place 2020-02-14 - 1.1.5 - fixed a few bugs - added slice - added splice and length, however Enumerable is not seen as an Array-like object, because length is a property not a field 2020-02-13 - 1.1.4 - Simplified the partition stack code 2020-02-09 - 1.1.3 - Added typings for Intellisense in TypeScript 2020-02-09 - 1.1.2 - optimized Quicksort and orderBy even more 2020-02-09 - 1.1.1 - separated the performance tests in their own files - small performance improvements - reverted the Quicksort algorithm to its original version - tried Timsort, it's pretty cool, but large and hard to control 2020-02-06 - 1.1.0 - change of algorithm for sorting - useQuickSort and useBrowserSort now just set the sort mechanism, QuickSort is default - added static Enumerable.sort(arr,comparer) which uses Quicksort to sort an array in place 2020-02-02 - 1.0.7 - library now exports Linqer as the module.exports object 2020-02-02 - 1.0.6 - used case sensitive main entry point 2020-02-02 - 1.0.5 - added Linqer.all.js for node.js use and used it as the main entry point - optimized sorting even more 2020-01-29 - 1.0.3 - updated README - moved binarySearch on Enumerable (the user has the responsibility to have it ordered) 2020-01-27 - 1.0.2 - added toList to return a seekable Enumerable - added lag and lead to return a join between the enumerable and itself with an offset - added padEnd and padStart to return enumerable of at least a specific length, filling the missing items with a given value 2020-01-23 - 1.0.1 - added randomSample functionality 2020-01-22 - 1.0.0 - official launch ================================================ FILE: build.bat ================================================ @ECHO OFF REM Delete Javascript files as we will generate them now DEL LInQer.extra.js DEL LInQer.extra.min.js DEL LInQer.js DEL LInQer.min.js DEL LInQer.slim.js DEL LInQer.slim.min.js DEL LInQer.all.js DEL LInQer.extra.js.map DEL LInQer.js.map DEL LInQer.slim.js.map DEL LInQer.all.js.map REM Requires npm install typescript -g call tsc --p tsconfig.json --sourceMap call tsc --p tsconfig.slim.json --sourceMap --noResolve call tsc --p tsconfig.extra.json --sourceMap --noResolve call tsc --p tsconfig.all.json --sourceMap ECHO export = Linqer; >> linqer.all.d.ts REM Delete intermediary Javascript files DEL LInQer.Enumerable.js DEL LInQer.GroupEnumerable.js DEL LInQer.OrderedEnumerable.js DEL LInQer.Enumerable.js.map DEL LInQer.GroupEnumerable.js.map DEL LInQer.OrderedEnumerable.js.map REM Requires npm install terser -g call terser --compress --mangle -o LInQer.min.js -- LInQer.js call terser --compress --mangle -o LInQer.slim.min.js -- LInQer.slim.js call terser --compress --mangle -o LInQer.extra.min.js -- LInQer.extra.js ================================================ FILE: npm.export.ts ================================================ // export to NPM if (typeof(module) !== 'undefined') { module.exports = Linqer; } ================================================ FILE: package.json ================================================ { "name": "@siderite/linqer", "version": "1.3.0", "description": "The C# Language Integrated Queries ported for Javascript for amazing performance", "main": "LInQer.all.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1" }, "repository": { "type": "git", "url": "git+https://github.com/Siderite/LInQer.git" }, "keywords": [ "LINQ", "Javascript", "ES6", "iterator", "generator", "Typescript" ], "author": "Siderite", "license": "MIT", "bugs": { "url": "https://github.com/Siderite/LInQer/issues" }, "homepage": "https://siderite.dev/blog/linq-in-javascript-linqer", "dependencies": { "@types/node": "^13.7.0" }, "devDependencies": {}, "typings": "./LInQer.all.d.ts" } ================================================ FILE: qUnit/qunit-2.9.2.css ================================================ /*! * QUnit 2.9.2 * https://qunitjs.com/ * * Copyright jQuery Foundation and other contributors * Released under the MIT license * https://jquery.org/license * * Date: 2019-02-21T22:49Z */ /** Font Family and Sizes */ #qunit-tests, #qunit-header, #qunit-banner, #qunit-testrunner-toolbar, #qunit-filteredTest, #qunit-userAgent, #qunit-testresult { font-family: "Helvetica Neue Light", "HelveticaNeue-Light", "Helvetica Neue", Calibri, Helvetica, Arial, sans-serif; } #qunit-testrunner-toolbar, #qunit-filteredTest, #qunit-userAgent, #qunit-testresult, #qunit-tests li { font-size: small; } #qunit-tests { font-size: smaller; } /** Resets */ #qunit-tests, #qunit-header, #qunit-banner, #qunit-filteredTest, #qunit-userAgent, #qunit-testresult, #qunit-modulefilter { margin: 0; padding: 0; } /** Header (excluding toolbar) */ #qunit-header { padding: 0.5em 0 0.5em 1em; color: #8699A4; background-color: #0D3349; font-size: 1.5em; line-height: 1em; font-weight: 400; border-radius: 5px 5px 0 0; } #qunit-header a { text-decoration: none; color: #C2CCD1; } #qunit-header a:hover, #qunit-header a:focus { color: #FFF; } #qunit-banner { height: 5px; } #qunit-filteredTest { padding: 0.5em 1em 0.5em 1em; color: #366097; background-color: #F4FF77; } #qunit-userAgent { padding: 0.5em 1em 0.5em 1em; color: #FFF; background-color: #2B81AF; text-shadow: rgba(0, 0, 0, 0.5) 2px 2px 1px; } /** Toolbar */ #qunit-testrunner-toolbar { padding: 0.5em 1em 0.5em 1em; color: #5E740B; background-color: #EEE; } #qunit-testrunner-toolbar .clearfix { height: 0; clear: both; } #qunit-testrunner-toolbar label { display: inline-block; } #qunit-testrunner-toolbar input[type=checkbox], #qunit-testrunner-toolbar input[type=radio] { margin: 3px; vertical-align: -2px; } #qunit-testrunner-toolbar input[type=text] { box-sizing: border-box; height: 1.6em; } .qunit-url-config, .qunit-filter, #qunit-modulefilter { display: inline-block; line-height: 2.1em; } .qunit-filter, #qunit-modulefilter { float: right; position: relative; margin-left: 1em; } .qunit-url-config label { margin-right: 0.5em; } #qunit-modulefilter-search { box-sizing: border-box; width: 400px; } #qunit-modulefilter-search-container:after { position: absolute; right: 0.3em; content: "\25bc"; color: black; } #qunit-modulefilter-dropdown { /* align with #qunit-modulefilter-search */ box-sizing: border-box; width: 400px; position: absolute; right: 0; top: 50%; margin-top: 0.8em; border: 1px solid #D3D3D3; border-top: none; border-radius: 0 0 .25em .25em; color: #000; background-color: #F5F5F5; z-index: 99; } #qunit-modulefilter-dropdown a { color: inherit; text-decoration: none; } #qunit-modulefilter-dropdown .clickable.checked { font-weight: bold; color: #000; background-color: #D2E0E6; } #qunit-modulefilter-dropdown .clickable:hover { color: #FFF; background-color: #0D3349; } #qunit-modulefilter-actions { display: block; overflow: auto; /* align with #qunit-modulefilter-dropdown-list */ font: smaller/1.5em sans-serif; } #qunit-modulefilter-dropdown #qunit-modulefilter-actions > * { box-sizing: border-box; max-height: 2.8em; display: block; padding: 0.4em; } #qunit-modulefilter-dropdown #qunit-modulefilter-actions > button { float: right; font: inherit; } #qunit-modulefilter-dropdown #qunit-modulefilter-actions > :last-child { /* insert padding to align with checkbox margins */ padding-left: 3px; } #qunit-modulefilter-dropdown-list { max-height: 200px; overflow-y: auto; margin: 0; border-top: 2px groove threedhighlight; padding: 0.4em 0 0; font: smaller/1.5em sans-serif; } #qunit-modulefilter-dropdown-list li { white-space: nowrap; overflow: hidden; text-overflow: ellipsis; } #qunit-modulefilter-dropdown-list .clickable { display: block; padding-left: 0.15em; } /** Tests: Pass/Fail */ #qunit-tests { list-style-position: inside; } #qunit-tests li { padding: 0.4em 1em 0.4em 1em; border-bottom: 1px solid #FFF; list-style-position: inside; } #qunit-tests > li { display: none; } #qunit-tests li.running, #qunit-tests li.pass, #qunit-tests li.fail, #qunit-tests li.skipped, #qunit-tests li.aborted { display: list-item; } #qunit-tests.hidepass { position: relative; } #qunit-tests.hidepass li.running, #qunit-tests.hidepass li.pass:not(.todo) { visibility: hidden; position: absolute; width: 0; height: 0; padding: 0; border: 0; margin: 0; } #qunit-tests li strong { cursor: pointer; } #qunit-tests li.skipped strong { cursor: default; } #qunit-tests li a { padding: 0.5em; color: #C2CCD1; text-decoration: none; } #qunit-tests li p a { padding: 0.25em; color: #6B6464; } #qunit-tests li a:hover, #qunit-tests li a:focus { color: #000; } #qunit-tests li .runtime { float: right; font-size: smaller; } .qunit-assert-list { margin-top: 0.5em; padding: 0.5em; background-color: #FFF; border-radius: 5px; } .qunit-source { margin: 0.6em 0 0.3em; } .qunit-collapsed { display: none; } #qunit-tests table { border-collapse: collapse; margin-top: 0.2em; } #qunit-tests th { text-align: right; vertical-align: top; padding: 0 0.5em 0 0; } #qunit-tests td { vertical-align: top; } #qunit-tests pre { margin: 0; white-space: pre-wrap; word-wrap: break-word; } #qunit-tests del { color: #374E0C; background-color: #E0F2BE; text-decoration: none; } #qunit-tests ins { color: #500; background-color: #FFCACA; text-decoration: none; } /*** Test Counts */ #qunit-tests b.counts { color: #000; } #qunit-tests b.passed { color: #5E740B; } #qunit-tests b.failed { color: #710909; } #qunit-tests li li { padding: 5px; background-color: #FFF; border-bottom: none; list-style-position: inside; } /*** Passing Styles */ #qunit-tests li li.pass { color: #3C510C; background-color: #FFF; border-left: 10px solid #C6E746; } #qunit-tests .pass { color: #528CE0; background-color: #D2E0E6; } #qunit-tests .pass .test-name { color: #366097; } #qunit-tests .pass .test-actual, #qunit-tests .pass .test-expected { color: #999; } #qunit-banner.qunit-pass { background-color: #C6E746; } /*** Failing Styles */ #qunit-tests li li.fail { color: #710909; background-color: #FFF; border-left: 10px solid #EE5757; white-space: pre; } #qunit-tests > li:last-child { border-radius: 0 0 5px 5px; } #qunit-tests .fail { color: #000; background-color: #EE5757; } #qunit-tests .fail .test-name, #qunit-tests .fail .module-name { color: #000; } #qunit-tests .fail .test-actual { color: #EE5757; } #qunit-tests .fail .test-expected { color: #008000; } #qunit-banner.qunit-fail { background-color: #EE5757; } /*** Aborted tests */ #qunit-tests .aborted { color: #000; background-color: orange; } /*** Skipped tests */ #qunit-tests .skipped { background-color: #EBECE9; } #qunit-tests .qunit-todo-label, #qunit-tests .qunit-skipped-label { background-color: #F4FF77; display: inline-block; font-style: normal; color: #366097; line-height: 1.8em; padding: 0 0.5em; margin: -0.4em 0.4em -0.4em 0; } #qunit-tests .qunit-todo-label { background-color: #EEE; } /** Result */ #qunit-testresult { color: #2B81AF; background-color: #D2E0E6; border-bottom: 1px solid #FFF; } #qunit-testresult .clearfix { height: 0; clear: both; } #qunit-testresult .module-name { font-weight: 700; } #qunit-testresult-display { padding: 0.5em 1em 0.5em 1em; width: 85%; float:left; } #qunit-testresult-controls { padding: 0.5em 1em 0.5em 1em; width: 10%; float:left; } /** Fixture */ #qunit-fixture { position: absolute; top: -10000px; left: -10000px; width: 1000px; height: 1000px; } ================================================ FILE: qUnit/qunit-2.9.2.js ================================================ /*! * QUnit 2.9.2 * https://qunitjs.com/ * * Copyright jQuery Foundation and other contributors * Released under the MIT license * https://jquery.org/license * * Date: 2019-02-21T22:49Z */ (function (global$1) { 'use strict'; global$1 = global$1 && global$1.hasOwnProperty('default') ? global$1['default'] : global$1; var window$1 = global$1.window; var self$1 = global$1.self; var console = global$1.console; var setTimeout$1 = global$1.setTimeout; var clearTimeout = global$1.clearTimeout; var document$1 = window$1 && window$1.document; var navigator = window$1 && window$1.navigator; var localSessionStorage = function () { var x = "qunit-test-string"; try { global$1.sessionStorage.setItem(x, x); global$1.sessionStorage.removeItem(x); return global$1.sessionStorage; } catch (e) { return undefined; } }(); /** * Returns a function that proxies to the given method name on the globals * console object. The proxy will also detect if the console doesn't exist and * will appropriately no-op. This allows support for IE9, which doesn't have a * console if the developer tools are not open. */ function consoleProxy(method) { return function () { if (console) { console[method].apply(console, arguments); } }; } var Logger = { warn: consoleProxy("warn") }; var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; var classCallCheck = function (instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }; var createClass = function () { function defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } } return function (Constructor, protoProps, staticProps) { if (protoProps) defineProperties(Constructor.prototype, protoProps); if (staticProps) defineProperties(Constructor, staticProps); return Constructor; }; }(); var toConsumableArray = function (arr) { if (Array.isArray(arr)) { for (var i = 0, arr2 = Array(arr.length); i < arr.length; i++) arr2[i] = arr[i]; return arr2; } else { return Array.from(arr); } }; var toString = Object.prototype.toString; var hasOwn = Object.prototype.hasOwnProperty; var now = Date.now || function () { return new Date().getTime(); }; var hasPerformanceApi = detectPerformanceApi(); var performance = hasPerformanceApi ? window$1.performance : undefined; var performanceNow = hasPerformanceApi ? performance.now.bind(performance) : now; function detectPerformanceApi() { return window$1 && typeof window$1.performance !== "undefined" && typeof window$1.performance.mark === "function" && typeof window$1.performance.measure === "function"; } function measure(comment, startMark, endMark) { // `performance.measure` may fail if the mark could not be found. // reasons a specific mark could not be found include: outside code invoking `performance.clearMarks()` try { performance.measure(comment, startMark, endMark); } catch (ex) { Logger.warn("performance.measure could not be executed because of ", ex.message); } } var defined = { document: window$1 && window$1.document !== undefined, setTimeout: setTimeout$1 !== undefined }; // Returns a new Array with the elements that are in a but not in b function diff(a, b) { var i, j, result = a.slice(); for (i = 0; i < result.length; i++) { for (j = 0; j < b.length; j++) { if (result[i] === b[j]) { result.splice(i, 1); i--; break; } } } return result; } /** * Determines whether an element exists in a given array or not. * * @method inArray * @param {Any} elem * @param {Array} array * @return {Boolean} */ function inArray(elem, array) { return array.indexOf(elem) !== -1; } /** * Makes a clone of an object using only Array or Object as base, * and copies over the own enumerable properties. * * @param {Object} obj * @return {Object} New object with only the own properties (recursively). */ function objectValues(obj) { var key, val, vals = is("array", obj) ? [] : {}; for (key in obj) { if (hasOwn.call(obj, key)) { val = obj[key]; vals[key] = val === Object(val) ? objectValues(val) : val; } } return vals; } function extend(a, b, undefOnly) { for (var prop in b) { if (hasOwn.call(b, prop)) { if (b[prop] === undefined) { delete a[prop]; } else if (!(undefOnly && typeof a[prop] !== "undefined")) { a[prop] = b[prop]; } } } return a; } function objectType(obj) { if (typeof obj === "undefined") { return "undefined"; } // Consider: typeof null === object if (obj === null) { return "null"; } var match = toString.call(obj).match(/^\[object\s(.*)\]$/), type = match && match[1]; switch (type) { case "Number": if (isNaN(obj)) { return "nan"; } return "number"; case "String": case "Boolean": case "Array": case "Set": case "Map": case "Date": case "RegExp": case "Function": case "Symbol": return type.toLowerCase(); default: return typeof obj === "undefined" ? "undefined" : _typeof(obj); } } // Safe object type checking function is(type, obj) { return objectType(obj) === type; } // Based on Java's String.hashCode, a simple but not // rigorously collision resistant hashing function function generateHash(module, testName) { var str = module + "\x1C" + testName; var hash = 0; for (var i = 0; i < str.length; i++) { hash = (hash << 5) - hash + str.charCodeAt(i); hash |= 0; } // Convert the possibly negative integer hash code into an 8 character hex string, which isn't // strictly necessary but increases user understanding that the id is a SHA-like hash var hex = (0x100000000 + hash).toString(16); if (hex.length < 8) { hex = "0000000" + hex; } return hex.slice(-8); } // Test for equality any JavaScript type. // Authors: Philippe Rathé , David Chan var equiv = (function () { // Value pairs queued for comparison. Used for breadth-first processing order, recursion // detection and avoiding repeated comparison (see below for details). // Elements are { a: val, b: val }. var pairs = []; var getProto = Object.getPrototypeOf || function (obj) { return obj.__proto__; }; function useStrictEquality(a, b) { // This only gets called if a and b are not strict equal, and is used to compare on // the primitive values inside object wrappers. For example: // `var i = 1;` // `var j = new Number(1);` // Neither a nor b can be null, as a !== b and they have the same type. if ((typeof a === "undefined" ? "undefined" : _typeof(a)) === "object") { a = a.valueOf(); } if ((typeof b === "undefined" ? "undefined" : _typeof(b)) === "object") { b = b.valueOf(); } return a === b; } function compareConstructors(a, b) { var protoA = getProto(a); var protoB = getProto(b); // Comparing constructors is more strict than using `instanceof` if (a.constructor === b.constructor) { return true; } // Ref #851 // If the obj prototype descends from a null constructor, treat it // as a null prototype. if (protoA && protoA.constructor === null) { protoA = null; } if (protoB && protoB.constructor === null) { protoB = null; } // Allow objects with no prototype to be equivalent to // objects with Object as their constructor. if (protoA === null && protoB === Object.prototype || protoB === null && protoA === Object.prototype) { return true; } return false; } function getRegExpFlags(regexp) { return "flags" in regexp ? regexp.flags : regexp.toString().match(/[gimuy]*$/)[0]; } function isContainer(val) { return ["object", "array", "map", "set"].indexOf(objectType(val)) !== -1; } function breadthFirstCompareChild(a, b) { // If a is a container not reference-equal to b, postpone the comparison to the // end of the pairs queue -- unless (a, b) has been seen before, in which case skip // over the pair. if (a === b) { return true; } if (!isContainer(a)) { return typeEquiv(a, b); } if (pairs.every(function (pair) { return pair.a !== a || pair.b !== b; })) { // Not yet started comparing this pair pairs.push({ a: a, b: b }); } return true; } var callbacks = { "string": useStrictEquality, "boolean": useStrictEquality, "number": useStrictEquality, "null": useStrictEquality, "undefined": useStrictEquality, "symbol": useStrictEquality, "date": useStrictEquality, "nan": function nan() { return true; }, "regexp": function regexp(a, b) { return a.source === b.source && // Include flags in the comparison getRegExpFlags(a) === getRegExpFlags(b); }, // abort (identical references / instance methods were skipped earlier) "function": function _function() { return false; }, "array": function array(a, b) { var i, len; len = a.length; if (len !== b.length) { // Safe and faster return false; } for (i = 0; i < len; i++) { // Compare non-containers; queue non-reference-equal containers if (!breadthFirstCompareChild(a[i], b[i])) { return false; } } return true; }, // Define sets a and b to be equivalent if for each element aVal in a, there // is some element bVal in b such that aVal and bVal are equivalent. Element // repetitions are not counted, so these are equivalent: // a = new Set( [ {}, [], [] ] ); // b = new Set( [ {}, {}, [] ] ); "set": function set$$1(a, b) { var innerEq, outerEq = true; if (a.size !== b.size) { // This optimization has certain quirks because of the lack of // repetition counting. For instance, adding the same // (reference-identical) element to two equivalent sets can // make them non-equivalent. return false; } a.forEach(function (aVal) { // Short-circuit if the result is already known. (Using for...of // with a break clause would be cleaner here, but it would cause // a syntax error on older Javascript implementations even if // Set is unused) if (!outerEq) { return; } innerEq = false; b.forEach(function (bVal) { var parentPairs; // Likewise, short-circuit if the result is already known if (innerEq) { return; } // Swap out the global pairs list, as the nested call to // innerEquiv will clobber its contents parentPairs = pairs; if (innerEquiv(bVal, aVal)) { innerEq = true; } // Replace the global pairs list pairs = parentPairs; }); if (!innerEq) { outerEq = false; } }); return outerEq; }, // Define maps a and b to be equivalent if for each key-value pair (aKey, aVal) // in a, there is some key-value pair (bKey, bVal) in b such that // [ aKey, aVal ] and [ bKey, bVal ] are equivalent. Key repetitions are not // counted, so these are equivalent: // a = new Map( [ [ {}, 1 ], [ {}, 1 ], [ [], 1 ] ] ); // b = new Map( [ [ {}, 1 ], [ [], 1 ], [ [], 1 ] ] ); "map": function map(a, b) { var innerEq, outerEq = true; if (a.size !== b.size) { // This optimization has certain quirks because of the lack of // repetition counting. For instance, adding the same // (reference-identical) key-value pair to two equivalent maps // can make them non-equivalent. return false; } a.forEach(function (aVal, aKey) { // Short-circuit if the result is already known. (Using for...of // with a break clause would be cleaner here, but it would cause // a syntax error on older Javascript implementations even if // Map is unused) if (!outerEq) { return; } innerEq = false; b.forEach(function (bVal, bKey) { var parentPairs; // Likewise, short-circuit if the result is already known if (innerEq) { return; } // Swap out the global pairs list, as the nested call to // innerEquiv will clobber its contents parentPairs = pairs; if (innerEquiv([bVal, bKey], [aVal, aKey])) { innerEq = true; } // Replace the global pairs list pairs = parentPairs; }); if (!innerEq) { outerEq = false; } }); return outerEq; }, "object": function object(a, b) { var i, aProperties = [], bProperties = []; if (compareConstructors(a, b) === false) { return false; } // Be strict: don't ensure hasOwnProperty and go deep for (i in a) { // Collect a's properties aProperties.push(i); // Skip OOP methods that look the same if (a.constructor !== Object && typeof a.constructor !== "undefined" && typeof a[i] === "function" && typeof b[i] === "function" && a[i].toString() === b[i].toString()) { continue; } // Compare non-containers; queue non-reference-equal containers if (!breadthFirstCompareChild(a[i], b[i])) { return false; } } for (i in b) { // Collect b's properties bProperties.push(i); } // Ensures identical properties name return typeEquiv(aProperties.sort(), bProperties.sort()); } }; function typeEquiv(a, b) { var type = objectType(a); // Callbacks for containers will append to the pairs queue to achieve breadth-first // search order. The pairs queue is also used to avoid reprocessing any pair of // containers that are reference-equal to a previously visited pair (a special case // this being recursion detection). // // Because of this approach, once typeEquiv returns a false value, it should not be // called again without clearing the pair queue else it may wrongly report a visited // pair as being equivalent. return objectType(b) === type && callbacks[type](a, b); } function innerEquiv(a, b) { var i, pair; // We're done when there's nothing more to compare if (arguments.length < 2) { return true; } // Clear the global pair queue and add the top-level values being compared pairs = [{ a: a, b: b }]; for (i = 0; i < pairs.length; i++) { pair = pairs[i]; // Perform type-specific comparison on any pairs that are not strictly // equal. For container types, that comparison will postpone comparison // of any sub-container pair to the end of the pair queue. This gives // breadth-first search order. It also avoids the reprocessing of // reference-equal siblings, cousins etc, which can have a significant speed // impact when comparing a container of small objects each of which has a // reference to the same (singleton) large object. if (pair.a !== pair.b && !typeEquiv(pair.a, pair.b)) { return false; } } // ...across all consecutive argument pairs return arguments.length === 2 || innerEquiv.apply(this, [].slice.call(arguments, 1)); } return function () { var result = innerEquiv.apply(undefined, arguments); // Release any retained objects pairs.length = 0; return result; }; })(); /** * Config object: Maintain internal state * Later exposed as QUnit.config * `config` initialized at top of scope */ var config = { // The queue of tests to run queue: [], // Block until document ready blocking: true, // By default, run previously failed tests first // very useful in combination with "Hide passed tests" checked reorder: true, // By default, modify document.title when suite is done altertitle: true, // HTML Reporter: collapse every test except the first failing test // If false, all failing tests will be expanded collapse: true, // By default, scroll to top of the page when suite is done scrolltop: true, // Depth up-to which object will be dumped maxDepth: 5, // When enabled, all tests must call expect() requireExpects: false, // Placeholder for user-configurable form-exposed URL parameters urlConfig: [], // Set of all modules. modules: [], // The first unnamed module currentModule: { name: "", tests: [], childModules: [], testsRun: 0, unskippedTestsRun: 0, hooks: { before: [], beforeEach: [], afterEach: [], after: [] } }, callbacks: {}, // The storage module to use for reordering tests storage: localSessionStorage }; // take a predefined QUnit.config and extend the defaults var globalConfig = window$1 && window$1.QUnit && window$1.QUnit.config; // only extend the global config if there is no QUnit overload if (window$1 && window$1.QUnit && !window$1.QUnit.version) { extend(config, globalConfig); } // Push a loose unnamed module to the modules collection config.modules.push(config.currentModule); // Based on jsDump by Ariel Flesler // http://flesler.blogspot.com/2008/05/jsdump-pretty-dump-of-any-javascript.html var dump = (function () { function quote(str) { return "\"" + str.toString().replace(/\\/g, "\\\\").replace(/"/g, "\\\"") + "\""; } function literal(o) { return o + ""; } function join(pre, arr, post) { var s = dump.separator(), base = dump.indent(), inner = dump.indent(1); if (arr.join) { arr = arr.join("," + s + inner); } if (!arr) { return pre + post; } return [pre, inner + arr, base + post].join(s); } function array(arr, stack) { var i = arr.length, ret = new Array(i); if (dump.maxDepth && dump.depth > dump.maxDepth) { return "[object Array]"; } this.up(); while (i--) { ret[i] = this.parse(arr[i], undefined, stack); } this.down(); return join("[", ret, "]"); } function isArray(obj) { return ( //Native Arrays toString.call(obj) === "[object Array]" || // NodeList objects typeof obj.length === "number" && obj.item !== undefined && (obj.length ? obj.item(0) === obj[0] : obj.item(0) === null && obj[0] === undefined) ); } var reName = /^function (\w+)/, dump = { // The objType is used mostly internally, you can fix a (custom) type in advance parse: function parse(obj, objType, stack) { stack = stack || []; var res, parser, parserType, objIndex = stack.indexOf(obj); if (objIndex !== -1) { return "recursion(" + (objIndex - stack.length) + ")"; } objType = objType || this.typeOf(obj); parser = this.parsers[objType]; parserType = typeof parser === "undefined" ? "undefined" : _typeof(parser); if (parserType === "function") { stack.push(obj); res = parser.call(this, obj, stack); stack.pop(); return res; } return parserType === "string" ? parser : this.parsers.error; }, typeOf: function typeOf(obj) { var type; if (obj === null) { type = "null"; } else if (typeof obj === "undefined") { type = "undefined"; } else if (is("regexp", obj)) { type = "regexp"; } else if (is("date", obj)) { type = "date"; } else if (is("function", obj)) { type = "function"; } else if (obj.setInterval !== undefined && obj.document !== undefined && obj.nodeType === undefined) { type = "window"; } else if (obj.nodeType === 9) { type = "document"; } else if (obj.nodeType) { type = "node"; } else if (isArray(obj)) { type = "array"; } else if (obj.constructor === Error.prototype.constructor) { type = "error"; } else { type = typeof obj === "undefined" ? "undefined" : _typeof(obj); } return type; }, separator: function separator() { if (this.multiline) { return this.HTML ? "
" : "\n"; } else { return this.HTML ? " " : " "; } }, // Extra can be a number, shortcut for increasing-calling-decreasing indent: function indent(extra) { if (!this.multiline) { return ""; } var chr = this.indentChar; if (this.HTML) { chr = chr.replace(/\t/g, " ").replace(/ /g, " "); } return new Array(this.depth + (extra || 0)).join(chr); }, up: function up(a) { this.depth += a || 1; }, down: function down(a) { this.depth -= a || 1; }, setParser: function setParser(name, parser) { this.parsers[name] = parser; }, // The next 3 are exposed so you can use them quote: quote, literal: literal, join: join, depth: 1, maxDepth: config.maxDepth, // This is the list of parsers, to modify them, use dump.setParser parsers: { window: "[Window]", document: "[Document]", error: function error(_error) { return "Error(\"" + _error.message + "\")"; }, unknown: "[Unknown]", "null": "null", "undefined": "undefined", "function": function _function(fn) { var ret = "function", // Functions never have name in IE name = "name" in fn ? fn.name : (reName.exec(fn) || [])[1]; if (name) { ret += " " + name; } ret += "("; ret = [ret, dump.parse(fn, "functionArgs"), "){"].join(""); return join(ret, dump.parse(fn, "functionCode"), "}"); }, array: array, nodelist: array, "arguments": array, object: function object(map, stack) { var keys, key, val, i, nonEnumerableProperties, ret = []; if (dump.maxDepth && dump.depth > dump.maxDepth) { return "[object Object]"; } dump.up(); keys = []; for (key in map) { keys.push(key); } // Some properties are not always enumerable on Error objects. nonEnumerableProperties = ["message", "name"]; for (i in nonEnumerableProperties) { key = nonEnumerableProperties[i]; if (key in map && !inArray(key, keys)) { keys.push(key); } } keys.sort(); for (i = 0; i < keys.length; i++) { key = keys[i]; val = map[key]; ret.push(dump.parse(key, "key") + ": " + dump.parse(val, undefined, stack)); } dump.down(); return join("{", ret, "}"); }, node: function node(_node) { var len, i, val, open = dump.HTML ? "<" : "<", close = dump.HTML ? ">" : ">", tag = _node.nodeName.toLowerCase(), ret = open + tag, attrs = _node.attributes; if (attrs) { for (i = 0, len = attrs.length; i < len; i++) { val = attrs[i].nodeValue; // IE6 includes all attributes in .attributes, even ones not explicitly // set. Those have values like undefined, null, 0, false, "" or // "inherit". if (val && val !== "inherit") { ret += " " + attrs[i].nodeName + "=" + dump.parse(val, "attribute"); } } } ret += close; // Show content of TextNode or CDATASection if (_node.nodeType === 3 || _node.nodeType === 4) { ret += _node.nodeValue; } return ret + open + "/" + tag + close; }, // Function calls it internally, it's the arguments part of the function functionArgs: function functionArgs(fn) { var args, l = fn.length; if (!l) { return ""; } args = new Array(l); while (l--) { // 97 is 'a' args[l] = String.fromCharCode(97 + l); } return " " + args.join(", ") + " "; }, // Object calls it internally, the key part of an item in a map key: quote, // Function calls it internally, it's the content of the function functionCode: "[code]", // Node calls it internally, it's a html attribute value attribute: quote, string: quote, date: quote, regexp: literal, number: literal, "boolean": literal, symbol: function symbol(sym) { return sym.toString(); } }, // If true, entities are escaped ( <, >, \t, space and \n ) HTML: false, // Indentation unit indentChar: " ", // If true, items in a collection, are separated by a \n, else just a space. multiline: true }; return dump; })(); var SuiteReport = function () { function SuiteReport(name, parentSuite) { classCallCheck(this, SuiteReport); this.name = name; this.fullName = parentSuite ? parentSuite.fullName.concat(name) : []; this.tests = []; this.childSuites = []; if (parentSuite) { parentSuite.pushChildSuite(this); } } createClass(SuiteReport, [{ key: "start", value: function start(recordTime) { if (recordTime) { this._startTime = performanceNow(); if (performance) { var suiteLevel = this.fullName.length; performance.mark("qunit_suite_" + suiteLevel + "_start"); } } return { name: this.name, fullName: this.fullName.slice(), tests: this.tests.map(function (test) { return test.start(); }), childSuites: this.childSuites.map(function (suite) { return suite.start(); }), testCounts: { total: this.getTestCounts().total } }; } }, { key: "end", value: function end(recordTime) { if (recordTime) { this._endTime = performanceNow(); if (performance) { var suiteLevel = this.fullName.length; performance.mark("qunit_suite_" + suiteLevel + "_end"); var suiteName = this.fullName.join(" – "); measure(suiteLevel === 0 ? "QUnit Test Run" : "QUnit Test Suite: " + suiteName, "qunit_suite_" + suiteLevel + "_start", "qunit_suite_" + suiteLevel + "_end"); } } return { name: this.name, fullName: this.fullName.slice(), tests: this.tests.map(function (test) { return test.end(); }), childSuites: this.childSuites.map(function (suite) { return suite.end(); }), testCounts: this.getTestCounts(), runtime: this.getRuntime(), status: this.getStatus() }; } }, { key: "pushChildSuite", value: function pushChildSuite(suite) { this.childSuites.push(suite); } }, { key: "pushTest", value: function pushTest(test) { this.tests.push(test); } }, { key: "getRuntime", value: function getRuntime() { return this._endTime - this._startTime; } }, { key: "getTestCounts", value: function getTestCounts() { var counts = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : { passed: 0, failed: 0, skipped: 0, todo: 0, total: 0 }; counts = this.tests.reduce(function (counts, test) { if (test.valid) { counts[test.getStatus()]++; counts.total++; } return counts; }, counts); return this.childSuites.reduce(function (counts, suite) { return suite.getTestCounts(counts); }, counts); } }, { key: "getStatus", value: function getStatus() { var _getTestCounts = this.getTestCounts(), total = _getTestCounts.total, failed = _getTestCounts.failed, skipped = _getTestCounts.skipped, todo = _getTestCounts.todo; if (failed) { return "failed"; } else { if (skipped === total) { return "skipped"; } else if (todo === total) { return "todo"; } else { return "passed"; } } } }]); return SuiteReport; }(); var focused = false; var moduleStack = []; function createModule(name, testEnvironment, modifiers) { var parentModule = moduleStack.length ? moduleStack.slice(-1)[0] : null; var moduleName = parentModule !== null ? [parentModule.name, name].join(" > ") : name; var parentSuite = parentModule ? parentModule.suiteReport : globalSuite; var skip = parentModule !== null && parentModule.skip || modifiers.skip; var todo = parentModule !== null && parentModule.todo || modifiers.todo; var module = { name: moduleName, parentModule: parentModule, tests: [], moduleId: generateHash(moduleName), testsRun: 0, unskippedTestsRun: 0, childModules: [], suiteReport: new SuiteReport(name, parentSuite), // Pass along `skip` and `todo` properties from parent module, in case // there is one, to childs. And use own otherwise. // This property will be used to mark own tests and tests of child suites // as either `skipped` or `todo`. skip: skip, todo: skip ? false : todo }; var env = {}; if (parentModule) { parentModule.childModules.push(module); extend(env, parentModule.testEnvironment); } extend(env, testEnvironment); module.testEnvironment = env; config.modules.push(module); return module; } function processModule(name, options, executeNow) { var modifiers = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {}; if (objectType(options) === "function") { executeNow = options; options = undefined; } var module = createModule(name, options, modifiers); // Move any hooks to a 'hooks' object var testEnvironment = module.testEnvironment; var hooks = module.hooks = {}; setHookFromEnvironment(hooks, testEnvironment, "before"); setHookFromEnvironment(hooks, testEnvironment, "beforeEach"); setHookFromEnvironment(hooks, testEnvironment, "afterEach"); setHookFromEnvironment(hooks, testEnvironment, "after"); var moduleFns = { before: setHookFunction(module, "before"), beforeEach: setHookFunction(module, "beforeEach"), afterEach: setHookFunction(module, "afterEach"), after: setHookFunction(module, "after") }; var currentModule = config.currentModule; if (objectType(executeNow) === "function") { moduleStack.push(module); config.currentModule = module; executeNow.call(module.testEnvironment, moduleFns); moduleStack.pop(); module = module.parentModule || currentModule; } config.currentModule = module; function setHookFromEnvironment(hooks, environment, name) { var potentialHook = environment[name]; hooks[name] = typeof potentialHook === "function" ? [potentialHook] : []; delete environment[name]; } function setHookFunction(module, hookName) { return function setHook(callback) { module.hooks[hookName].push(callback); }; } } function module$1(name, options, executeNow) { if (focused) { return; } processModule(name, options, executeNow); } module$1.only = function () { if (focused) { return; } config.modules.length = 0; config.queue.length = 0; module$1.apply(undefined, arguments); focused = true; }; module$1.skip = function (name, options, executeNow) { if (focused) { return; } processModule(name, options, executeNow, { skip: true }); }; module$1.todo = function (name, options, executeNow) { if (focused) { return; } processModule(name, options, executeNow, { todo: true }); }; var LISTENERS = Object.create(null); var SUPPORTED_EVENTS = ["runStart", "suiteStart", "testStart", "assertion", "testEnd", "suiteEnd", "runEnd"]; /** * Emits an event with the specified data to all currently registered listeners. * Callbacks will fire in the order in which they are registered (FIFO). This * function is not exposed publicly; it is used by QUnit internals to emit * logging events. * * @private * @method emit * @param {String} eventName * @param {Object} data * @return {Void} */ function emit(eventName, data) { if (objectType(eventName) !== "string") { throw new TypeError("eventName must be a string when emitting an event"); } // Clone the callbacks in case one of them registers a new callback var originalCallbacks = LISTENERS[eventName]; var callbacks = originalCallbacks ? [].concat(toConsumableArray(originalCallbacks)) : []; for (var i = 0; i < callbacks.length; i++) { callbacks[i](data); } } /** * Registers a callback as a listener to the specified event. * * @public * @method on * @param {String} eventName * @param {Function} callback * @return {Void} */ function on(eventName, callback) { if (objectType(eventName) !== "string") { throw new TypeError("eventName must be a string when registering a listener"); } else if (!inArray(eventName, SUPPORTED_EVENTS)) { var events = SUPPORTED_EVENTS.join(", "); throw new Error("\"" + eventName + "\" is not a valid event; must be one of: " + events + "."); } else if (objectType(callback) !== "function") { throw new TypeError("callback must be a function when registering a listener"); } if (!LISTENERS[eventName]) { LISTENERS[eventName] = []; } // Don't register the same callback more than once if (!inArray(callback, LISTENERS[eventName])) { LISTENERS[eventName].push(callback); } } function objectOrFunction(x) { var type = typeof x === 'undefined' ? 'undefined' : _typeof(x); return x !== null && (type === 'object' || type === 'function'); } function isFunction(x) { return typeof x === 'function'; } var _isArray = void 0; if (Array.isArray) { _isArray = Array.isArray; } else { _isArray = function _isArray(x) { return Object.prototype.toString.call(x) === '[object Array]'; }; } var isArray = _isArray; var len = 0; var vertxNext = void 0; var customSchedulerFn = void 0; var asap = function asap(callback, arg) { queue[len] = callback; queue[len + 1] = arg; len += 2; if (len === 2) { // If len is 2, that means that we need to schedule an async flush. // If additional callbacks are queued before the queue is flushed, they // will be processed by this flush that we are scheduling. if (customSchedulerFn) { customSchedulerFn(flush); } else { scheduleFlush(); } } }; function setScheduler(scheduleFn) { customSchedulerFn = scheduleFn; } function setAsap(asapFn) { asap = asapFn; } var browserWindow = typeof window !== 'undefined' ? window : undefined; var browserGlobal = browserWindow || {}; var BrowserMutationObserver = browserGlobal.MutationObserver || browserGlobal.WebKitMutationObserver; var isNode = typeof self === 'undefined' && typeof process !== 'undefined' && {}.toString.call(process) === '[object process]'; // test for web worker but not in IE10 var isWorker = typeof Uint8ClampedArray !== 'undefined' && typeof importScripts !== 'undefined' && typeof MessageChannel !== 'undefined'; // node function useNextTick() { // node version 0.10.x displays a deprecation warning when nextTick is used recursively // see https://github.com/cujojs/when/issues/410 for details return function () { return process.nextTick(flush); }; } // vertx function useVertxTimer() { if (typeof vertxNext !== 'undefined') { return function () { vertxNext(flush); }; } return useSetTimeout(); } function useMutationObserver() { var iterations = 0; var observer = new BrowserMutationObserver(flush); var node = document.createTextNode(''); observer.observe(node, { characterData: true }); return function () { node.data = iterations = ++iterations % 2; }; } // web worker function useMessageChannel() { var channel = new MessageChannel(); channel.port1.onmessage = flush; return function () { return channel.port2.postMessage(0); }; } function useSetTimeout() { // Store setTimeout reference so es6-promise will be unaffected by // other code modifying setTimeout (like sinon.useFakeTimers()) var globalSetTimeout = setTimeout; return function () { return globalSetTimeout(flush, 1); }; } var queue = new Array(1000); function flush() { for (var i = 0; i < len; i += 2) { var callback = queue[i]; var arg = queue[i + 1]; callback(arg); queue[i] = undefined; queue[i + 1] = undefined; } len = 0; } function attemptVertx() { try { var vertx = Function('return this')().require('vertx'); vertxNext = vertx.runOnLoop || vertx.runOnContext; return useVertxTimer(); } catch (e) { return useSetTimeout(); } } var scheduleFlush = void 0; // Decide what async method to use to triggering processing of queued callbacks: if (isNode) { scheduleFlush = useNextTick(); } else if (BrowserMutationObserver) { scheduleFlush = useMutationObserver(); } else if (isWorker) { scheduleFlush = useMessageChannel(); } else if (browserWindow === undefined && typeof require === 'function') { scheduleFlush = attemptVertx(); } else { scheduleFlush = useSetTimeout(); } function then(onFulfillment, onRejection) { var parent = this; var child = new this.constructor(noop); if (child[PROMISE_ID] === undefined) { makePromise(child); } var _state = parent._state; if (_state) { var callback = arguments[_state - 1]; asap(function () { return invokeCallback(_state, child, callback, parent._result); }); } else { subscribe(parent, child, onFulfillment, onRejection); } return child; } /** `Promise.resolve` returns a promise that will become resolved with the passed `value`. It is shorthand for the following: ```javascript let promise = new Promise(function(resolve, reject){ resolve(1); }); promise.then(function(value){ // value === 1 }); ``` Instead of writing the above, your code now simply becomes the following: ```javascript let promise = Promise.resolve(1); promise.then(function(value){ // value === 1 }); ``` @method resolve @static @param {Any} value value that the returned promise will be resolved with Useful for tooling. @return {Promise} a promise that will become fulfilled with the given `value` */ function resolve$1(object) { /*jshint validthis:true */ var Constructor = this; if (object && (typeof object === 'undefined' ? 'undefined' : _typeof(object)) === 'object' && object.constructor === Constructor) { return object; } var promise = new Constructor(noop); resolve(promise, object); return promise; } var PROMISE_ID = Math.random().toString(36).substring(2); function noop() {} var PENDING = void 0; var FULFILLED = 1; var REJECTED = 2; var TRY_CATCH_ERROR = { error: null }; function selfFulfillment() { return new TypeError("You cannot resolve a promise with itself"); } function cannotReturnOwn() { return new TypeError('A promises callback cannot return that same promise.'); } function getThen(promise) { try { return promise.then; } catch (error) { TRY_CATCH_ERROR.error = error; return TRY_CATCH_ERROR; } } function tryThen(then$$1, value, fulfillmentHandler, rejectionHandler) { try { then$$1.call(value, fulfillmentHandler, rejectionHandler); } catch (e) { return e; } } function handleForeignThenable(promise, thenable, then$$1) { asap(function (promise) { var sealed = false; var error = tryThen(then$$1, thenable, function (value) { if (sealed) { return; } sealed = true; if (thenable !== value) { resolve(promise, value); } else { fulfill(promise, value); } }, function (reason) { if (sealed) { return; } sealed = true; reject(promise, reason); }, 'Settle: ' + (promise._label || ' unknown promise')); if (!sealed && error) { sealed = true; reject(promise, error); } }, promise); } function handleOwnThenable(promise, thenable) { if (thenable._state === FULFILLED) { fulfill(promise, thenable._result); } else if (thenable._state === REJECTED) { reject(promise, thenable._result); } else { subscribe(thenable, undefined, function (value) { return resolve(promise, value); }, function (reason) { return reject(promise, reason); }); } } function handleMaybeThenable(promise, maybeThenable, then$$1) { if (maybeThenable.constructor === promise.constructor && then$$1 === then && maybeThenable.constructor.resolve === resolve$1) { handleOwnThenable(promise, maybeThenable); } else { if (then$$1 === TRY_CATCH_ERROR) { reject(promise, TRY_CATCH_ERROR.error); TRY_CATCH_ERROR.error = null; } else if (then$$1 === undefined) { fulfill(promise, maybeThenable); } else if (isFunction(then$$1)) { handleForeignThenable(promise, maybeThenable, then$$1); } else { fulfill(promise, maybeThenable); } } } function resolve(promise, value) { if (promise === value) { reject(promise, selfFulfillment()); } else if (objectOrFunction(value)) { handleMaybeThenable(promise, value, getThen(value)); } else { fulfill(promise, value); } } function publishRejection(promise) { if (promise._onerror) { promise._onerror(promise._result); } publish(promise); } function fulfill(promise, value) { if (promise._state !== PENDING) { return; } promise._result = value; promise._state = FULFILLED; if (promise._subscribers.length !== 0) { asap(publish, promise); } } function reject(promise, reason) { if (promise._state !== PENDING) { return; } promise._state = REJECTED; promise._result = reason; asap(publishRejection, promise); } function subscribe(parent, child, onFulfillment, onRejection) { var _subscribers = parent._subscribers; var length = _subscribers.length; parent._onerror = null; _subscribers[length] = child; _subscribers[length + FULFILLED] = onFulfillment; _subscribers[length + REJECTED] = onRejection; if (length === 0 && parent._state) { asap(publish, parent); } } function publish(promise) { var subscribers = promise._subscribers; var settled = promise._state; if (subscribers.length === 0) { return; } var child = void 0, callback = void 0, detail = promise._result; for (var i = 0; i < subscribers.length; i += 3) { child = subscribers[i]; callback = subscribers[i + settled]; if (child) { invokeCallback(settled, child, callback, detail); } else { callback(detail); } } promise._subscribers.length = 0; } function tryCatch(callback, detail) { try { return callback(detail); } catch (e) { TRY_CATCH_ERROR.error = e; return TRY_CATCH_ERROR; } } function invokeCallback(settled, promise, callback, detail) { var hasCallback = isFunction(callback), value = void 0, error = void 0, succeeded = void 0, failed = void 0; if (hasCallback) { value = tryCatch(callback, detail); if (value === TRY_CATCH_ERROR) { failed = true; error = value.error; value.error = null; } else { succeeded = true; } if (promise === value) { reject(promise, cannotReturnOwn()); return; } } else { value = detail; succeeded = true; } if (promise._state !== PENDING) { // noop } else if (hasCallback && succeeded) { resolve(promise, value); } else if (failed) { reject(promise, error); } else if (settled === FULFILLED) { fulfill(promise, value); } else if (settled === REJECTED) { reject(promise, value); } } function initializePromise(promise, resolver) { try { resolver(function resolvePromise(value) { resolve(promise, value); }, function rejectPromise(reason) { reject(promise, reason); }); } catch (e) { reject(promise, e); } } var id = 0; function nextId() { return id++; } function makePromise(promise) { promise[PROMISE_ID] = id++; promise._state = undefined; promise._result = undefined; promise._subscribers = []; } function validationError() { return new Error('Array Methods must be provided an Array'); } var Enumerator = function () { function Enumerator(Constructor, input) { classCallCheck(this, Enumerator); this._instanceConstructor = Constructor; this.promise = new Constructor(noop); if (!this.promise[PROMISE_ID]) { makePromise(this.promise); } if (isArray(input)) { this.length = input.length; this._remaining = input.length; this._result = new Array(this.length); if (this.length === 0) { fulfill(this.promise, this._result); } else { this.length = this.length || 0; this._enumerate(input); if (this._remaining === 0) { fulfill(this.promise, this._result); } } } else { reject(this.promise, validationError()); } } createClass(Enumerator, [{ key: '_enumerate', value: function _enumerate(input) { for (var i = 0; this._state === PENDING && i < input.length; i++) { this._eachEntry(input[i], i); } } }, { key: '_eachEntry', value: function _eachEntry(entry, i) { var c = this._instanceConstructor; var resolve$$1 = c.resolve; if (resolve$$1 === resolve$1) { var _then = getThen(entry); if (_then === then && entry._state !== PENDING) { this._settledAt(entry._state, i, entry._result); } else if (typeof _then !== 'function') { this._remaining--; this._result[i] = entry; } else if (c === Promise$2) { var promise = new c(noop); handleMaybeThenable(promise, entry, _then); this._willSettleAt(promise, i); } else { this._willSettleAt(new c(function (resolve$$1) { return resolve$$1(entry); }), i); } } else { this._willSettleAt(resolve$$1(entry), i); } } }, { key: '_settledAt', value: function _settledAt(state, i, value) { var promise = this.promise; if (promise._state === PENDING) { this._remaining--; if (state === REJECTED) { reject(promise, value); } else { this._result[i] = value; } } if (this._remaining === 0) { fulfill(promise, this._result); } } }, { key: '_willSettleAt', value: function _willSettleAt(promise, i) { var enumerator = this; subscribe(promise, undefined, function (value) { return enumerator._settledAt(FULFILLED, i, value); }, function (reason) { return enumerator._settledAt(REJECTED, i, reason); }); } }]); return Enumerator; }(); /** `Promise.all` accepts an array of promises, and returns a new promise which is fulfilled with an array of fulfillment values for the passed promises, or rejected with the reason of the first passed promise to be rejected. It casts all elements of the passed iterable to promises as it runs this algorithm. Example: ```javascript let promise1 = resolve(1); let promise2 = resolve(2); let promise3 = resolve(3); let promises = [ promise1, promise2, promise3 ]; Promise.all(promises).then(function(array){ // The array here would be [ 1, 2, 3 ]; }); ``` If any of the `promises` given to `all` are rejected, the first promise that is rejected will be given as an argument to the returned promises's rejection handler. For example: Example: ```javascript let promise1 = resolve(1); let promise2 = reject(new Error("2")); let promise3 = reject(new Error("3")); let promises = [ promise1, promise2, promise3 ]; Promise.all(promises).then(function(array){ // Code here never runs because there are rejected promises! }, function(error) { // error.message === "2" }); ``` @method all @static @param {Array} entries array of promises @param {String} label optional string for labeling the promise. Useful for tooling. @return {Promise} promise that is fulfilled when all `promises` have been fulfilled, or rejected if any of them become rejected. @static */ function all(entries) { return new Enumerator(this, entries).promise; } /** `Promise.race` returns a new promise which is settled in the same way as the first passed promise to settle. Example: ```javascript let promise1 = new Promise(function(resolve, reject){ setTimeout(function(){ resolve('promise 1'); }, 200); }); let promise2 = new Promise(function(resolve, reject){ setTimeout(function(){ resolve('promise 2'); }, 100); }); Promise.race([promise1, promise2]).then(function(result){ // result === 'promise 2' because it was resolved before promise1 // was resolved. }); ``` `Promise.race` is deterministic in that only the state of the first settled promise matters. For example, even if other promises given to the `promises` array argument are resolved, but the first settled promise has become rejected before the other promises became fulfilled, the returned promise will become rejected: ```javascript let promise1 = new Promise(function(resolve, reject){ setTimeout(function(){ resolve('promise 1'); }, 200); }); let promise2 = new Promise(function(resolve, reject){ setTimeout(function(){ reject(new Error('promise 2')); }, 100); }); Promise.race([promise1, promise2]).then(function(result){ // Code here never runs }, function(reason){ // reason.message === 'promise 2' because promise 2 became rejected before // promise 1 became fulfilled }); ``` An example real-world use case is implementing timeouts: ```javascript Promise.race([ajax('foo.json'), timeout(5000)]) ``` @method race @static @param {Array} promises array of promises to observe Useful for tooling. @return {Promise} a promise which settles in the same way as the first passed promise to settle. */ function race(entries) { /*jshint validthis:true */ var Constructor = this; if (!isArray(entries)) { return new Constructor(function (_, reject) { return reject(new TypeError('You must pass an array to race.')); }); } else { return new Constructor(function (resolve, reject) { var length = entries.length; for (var i = 0; i < length; i++) { Constructor.resolve(entries[i]).then(resolve, reject); } }); } } /** `Promise.reject` returns a promise rejected with the passed `reason`. It is shorthand for the following: ```javascript let promise = new Promise(function(resolve, reject){ reject(new Error('WHOOPS')); }); promise.then(function(value){ // Code here doesn't run because the promise is rejected! }, function(reason){ // reason.message === 'WHOOPS' }); ``` Instead of writing the above, your code now simply becomes the following: ```javascript let promise = Promise.reject(new Error('WHOOPS')); promise.then(function(value){ // Code here doesn't run because the promise is rejected! }, function(reason){ // reason.message === 'WHOOPS' }); ``` @method reject @static @param {Any} reason value that the returned promise will be rejected with. Useful for tooling. @return {Promise} a promise rejected with the given `reason`. */ function reject$1(reason) { /*jshint validthis:true */ var Constructor = this; var promise = new Constructor(noop); reject(promise, reason); return promise; } function needsResolver() { throw new TypeError('You must pass a resolver function as the first argument to the promise constructor'); } function needsNew() { throw new TypeError("Failed to construct 'Promise': Please use the 'new' operator, this object constructor cannot be called as a function."); } /** Promise objects represent the eventual result of an asynchronous operation. The primary way of interacting with a promise is through its `then` method, which registers callbacks to receive either a promise's eventual value or the reason why the promise cannot be fulfilled. Terminology ----------- - `promise` is an object or function with a `then` method whose behavior conforms to this specification. - `thenable` is an object or function that defines a `then` method. - `value` is any legal JavaScript value (including undefined, a thenable, or a promise). - `exception` is a value that is thrown using the throw statement. - `reason` is a value that indicates why a promise was rejected. - `settled` the final resting state of a promise, fulfilled or rejected. A promise can be in one of three states: pending, fulfilled, or rejected. Promises that are fulfilled have a fulfillment value and are in the fulfilled state. Promises that are rejected have a rejection reason and are in the rejected state. A fulfillment value is never a thenable. Promises can also be said to *resolve* a value. If this value is also a promise, then the original promise's settled state will match the value's settled state. So a promise that *resolves* a promise that rejects will itself reject, and a promise that *resolves* a promise that fulfills will itself fulfill. Basic Usage: ------------ ```js let promise = new Promise(function(resolve, reject) { // on success resolve(value); // on failure reject(reason); }); promise.then(function(value) { // on fulfillment }, function(reason) { // on rejection }); ``` Advanced Usage: --------------- Promises shine when abstracting away asynchronous interactions such as `XMLHttpRequest`s. ```js function getJSON(url) { return new Promise(function(resolve, reject){ let xhr = new XMLHttpRequest(); xhr.open('GET', url); xhr.onreadystatechange = handler; xhr.responseType = 'json'; xhr.setRequestHeader('Accept', 'application/json'); xhr.send(); function handler() { if (this.readyState === this.DONE) { if (this.status === 200) { resolve(this.response); } else { reject(new Error('getJSON: `' + url + '` failed with status: [' + this.status + ']')); } } }; }); } getJSON('/posts.json').then(function(json) { // on fulfillment }, function(reason) { // on rejection }); ``` Unlike callbacks, promises are great composable primitives. ```js Promise.all([ getJSON('/posts'), getJSON('/comments') ]).then(function(values){ values[0] // => postsJSON values[1] // => commentsJSON return values; }); ``` @class Promise @param {Function} resolver Useful for tooling. @constructor */ var Promise$2 = function () { function Promise(resolver) { classCallCheck(this, Promise); this[PROMISE_ID] = nextId(); this._result = this._state = undefined; this._subscribers = []; if (noop !== resolver) { typeof resolver !== 'function' && needsResolver(); this instanceof Promise ? initializePromise(this, resolver) : needsNew(); } } /** The primary way of interacting with a promise is through its `then` method, which registers callbacks to receive either a promise's eventual value or the reason why the promise cannot be fulfilled. ```js findUser().then(function(user){ // user is available }, function(reason){ // user is unavailable, and you are given the reason why }); ``` Chaining -------- The return value of `then` is itself a promise. This second, 'downstream' promise is resolved with the return value of the first promise's fulfillment or rejection handler, or rejected if the handler throws an exception. ```js findUser().then(function (user) { return user.name; }, function (reason) { return 'default name'; }).then(function (userName) { // If `findUser` fulfilled, `userName` will be the user's name, otherwise it // will be `'default name'` }); findUser().then(function (user) { throw new Error('Found user, but still unhappy'); }, function (reason) { throw new Error('`findUser` rejected and we're unhappy'); }).then(function (value) { // never reached }, function (reason) { // if `findUser` fulfilled, `reason` will be 'Found user, but still unhappy'. // If `findUser` rejected, `reason` will be '`findUser` rejected and we're unhappy'. }); ``` If the downstream promise does not specify a rejection handler, rejection reasons will be propagated further downstream. ```js findUser().then(function (user) { throw new PedagogicalException('Upstream error'); }).then(function (value) { // never reached }).then(function (value) { // never reached }, function (reason) { // The `PedgagocialException` is propagated all the way down to here }); ``` Assimilation ------------ Sometimes the value you want to propagate to a downstream promise can only be retrieved asynchronously. This can be achieved by returning a promise in the fulfillment or rejection handler. The downstream promise will then be pending until the returned promise is settled. This is called *assimilation*. ```js findUser().then(function (user) { return findCommentsByAuthor(user); }).then(function (comments) { // The user's comments are now available }); ``` If the assimliated promise rejects, then the downstream promise will also reject. ```js findUser().then(function (user) { return findCommentsByAuthor(user); }).then(function (comments) { // If `findCommentsByAuthor` fulfills, we'll have the value here }, function (reason) { // If `findCommentsByAuthor` rejects, we'll have the reason here }); ``` Simple Example -------------- Synchronous Example ```javascript let result; try { result = findResult(); // success } catch(reason) { // failure } ``` Errback Example ```js findResult(function(result, err){ if (err) { // failure } else { // success } }); ``` Promise Example; ```javascript findResult().then(function(result){ // success }, function(reason){ // failure }); ``` Advanced Example -------------- Synchronous Example ```javascript let author, books; try { author = findAuthor(); books = findBooksByAuthor(author); // success } catch(reason) { // failure } ``` Errback Example ```js function foundBooks(books) { } function failure(reason) { } findAuthor(function(author, err){ if (err) { failure(err); // failure } else { try { findBoooksByAuthor(author, function(books, err) { if (err) { failure(err); } else { try { foundBooks(books); } catch(reason) { failure(reason); } } }); } catch(error) { failure(err); } // success } }); ``` Promise Example; ```javascript findAuthor(). then(findBooksByAuthor). then(function(books){ // found books }).catch(function(reason){ // something went wrong }); ``` @method then @param {Function} onFulfilled @param {Function} onRejected Useful for tooling. @return {Promise} */ /** `catch` is simply sugar for `then(undefined, onRejection)` which makes it the same as the catch block of a try/catch statement. ```js function findAuthor(){ throw new Error('couldn't find that author'); } // synchronous try { findAuthor(); } catch(reason) { // something went wrong } // async with promises findAuthor().catch(function(reason){ // something went wrong }); ``` @method catch @param {Function} onRejection Useful for tooling. @return {Promise} */ createClass(Promise, [{ key: 'catch', value: function _catch(onRejection) { return this.then(null, onRejection); } /** `finally` will be invoked regardless of the promise's fate just as native try/catch/finally behaves Synchronous example: ```js findAuthor() { if (Math.random() > 0.5) { throw new Error(); } return new Author(); } try { return findAuthor(); // succeed or fail } catch(error) { return findOtherAuther(); } finally { // always runs // doesn't affect the return value } ``` Asynchronous example: ```js findAuthor().catch(function(reason){ return findOtherAuther(); }).finally(function(){ // author was either found, or not }); ``` @method finally @param {Function} callback @return {Promise} */ }, { key: 'finally', value: function _finally(callback) { var promise = this; var constructor = promise.constructor; if (isFunction(callback)) { return promise.then(function (value) { return constructor.resolve(callback()).then(function () { return value; }); }, function (reason) { return constructor.resolve(callback()).then(function () { throw reason; }); }); } return promise.then(callback, callback); } }]); return Promise; }(); Promise$2.prototype.then = then; Promise$2.all = all; Promise$2.race = race; Promise$2.resolve = resolve$1; Promise$2.reject = reject$1; Promise$2._setScheduler = setScheduler; Promise$2._setAsap = setAsap; Promise$2._asap = asap; /*global self*/ function polyfill() { var local = void 0; if (typeof global !== 'undefined') { local = global; } else if (typeof self !== 'undefined') { local = self; } else { try { local = Function('return this')(); } catch (e) { throw new Error('polyfill failed because global object is unavailable in this environment'); } } var P = local.Promise; if (P) { var promiseToString = null; try { promiseToString = Object.prototype.toString.call(P.resolve()); } catch (e) { // silently ignored } if (promiseToString === '[object Promise]' && !P.cast) { return; } } local.Promise = Promise$2; } // Strange compat.. Promise$2.polyfill = polyfill; Promise$2.Promise = Promise$2; var Promise$1 = typeof Promise !== "undefined" ? Promise : Promise$2; // Register logging callbacks function registerLoggingCallbacks(obj) { var i, l, key, callbackNames = ["begin", "done", "log", "testStart", "testDone", "moduleStart", "moduleDone"]; function registerLoggingCallback(key) { var loggingCallback = function loggingCallback(callback) { if (objectType(callback) !== "function") { throw new Error("QUnit logging methods require a callback function as their first parameters."); } config.callbacks[key].push(callback); }; return loggingCallback; } for (i = 0, l = callbackNames.length; i < l; i++) { key = callbackNames[i]; // Initialize key collection of logging callback if (objectType(config.callbacks[key]) === "undefined") { config.callbacks[key] = []; } obj[key] = registerLoggingCallback(key); } } function runLoggingCallbacks(key, args) { var callbacks = config.callbacks[key]; // Handling 'log' callbacks separately. Unlike the other callbacks, // the log callback is not controlled by the processing queue, // but rather used by asserts. Hence to promisfy the 'log' callback // would mean promisfying each step of a test if (key === "log") { callbacks.map(function (callback) { return callback(args); }); return; } // ensure that each callback is executed serially return callbacks.reduce(function (promiseChain, callback) { return promiseChain.then(function () { return Promise$1.resolve(callback(args)); }); }, Promise$1.resolve([])); } // Doesn't support IE9, it will return undefined on these browsers // See also https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Error/Stack var fileName = (sourceFromStacktrace(0) || "").replace(/(:\d+)+\)?/, "").replace(/.+\//, ""); function extractStacktrace(e, offset) { offset = offset === undefined ? 4 : offset; var stack, include, i; if (e && e.stack) { stack = e.stack.split("\n"); if (/^error$/i.test(stack[0])) { stack.shift(); } if (fileName) { include = []; for (i = offset; i < stack.length; i++) { if (stack[i].indexOf(fileName) !== -1) { break; } include.push(stack[i]); } if (include.length) { return include.join("\n"); } } return stack[offset]; } } function sourceFromStacktrace(offset) { var error = new Error(); // Support: Safari <=7 only, IE <=10 - 11 only // Not all browsers generate the `stack` property for `new Error()`, see also #636 if (!error.stack) { try { throw error; } catch (err) { error = err; } } return extractStacktrace(error, offset); } var priorityCount = 0; var unitSampler = void 0; // This is a queue of functions that are tasks within a single test. // After tests are dequeued from config.queue they are expanded into // a set of tasks in this queue. var taskQueue = []; /** * Advances the taskQueue to the next task. If the taskQueue is empty, * process the testQueue */ function advance() { advanceTaskQueue(); if (!taskQueue.length && !config.blocking && !config.current) { advanceTestQueue(); } } /** * Advances the taskQueue with an increased depth */ function advanceTaskQueue() { var start = now(); config.depth = (config.depth || 0) + 1; processTaskQueue(start); config.depth--; } /** * Process the first task on the taskQueue as a promise. * Each task is a function returned by https://github.com/qunitjs/qunit/blob/master/src/test.js#L381 */ function processTaskQueue(start) { if (taskQueue.length && !config.blocking) { var elapsedTime = now() - start; if (!defined.setTimeout || config.updateRate <= 0 || elapsedTime < config.updateRate) { var task = taskQueue.shift(); Promise$1.resolve(task()).then(function () { if (!taskQueue.length) { advance(); } else { processTaskQueue(start); } }); } else { setTimeout$1(advance); } } } /** * Advance the testQueue to the next test to process. Call done() if testQueue completes. */ function advanceTestQueue() { if (!config.blocking && !config.queue.length && config.depth === 0) { done(); return; } var testTasks = config.queue.shift(); addToTaskQueue(testTasks()); if (priorityCount > 0) { priorityCount--; } advance(); } /** * Enqueue the tasks for a test into the task queue. * @param {Array} tasksArray */ function addToTaskQueue(tasksArray) { taskQueue.push.apply(taskQueue, toConsumableArray(tasksArray)); } /** * Return the number of tasks remaining in the task queue to be processed. * @return {Number} */ function taskQueueLength() { return taskQueue.length; } /** * Adds a test to the TestQueue for execution. * @param {Function} testTasksFunc * @param {Boolean} prioritize * @param {String} seed */ function addToTestQueue(testTasksFunc, prioritize, seed) { if (prioritize) { config.queue.splice(priorityCount++, 0, testTasksFunc); } else if (seed) { if (!unitSampler) { unitSampler = unitSamplerGenerator(seed); } // Insert into a random position after all prioritized items var index = Math.floor(unitSampler() * (config.queue.length - priorityCount + 1)); config.queue.splice(priorityCount + index, 0, testTasksFunc); } else { config.queue.push(testTasksFunc); } } /** * Creates a seeded "sample" generator which is used for randomizing tests. */ function unitSamplerGenerator(seed) { // 32-bit xorshift, requires only a nonzero seed // http://excamera.com/sphinx/article-xorshift.html var sample = parseInt(generateHash(seed), 16) || -1; return function () { sample ^= sample << 13; sample ^= sample >>> 17; sample ^= sample << 5; // ECMAScript has no unsigned number type if (sample < 0) { sample += 0x100000000; } return sample / 0x100000000; }; } /** * This function is called when the ProcessingQueue is done processing all * items. It handles emitting the final run events. */ function done() { var storage = config.storage; ProcessingQueue.finished = true; var runtime = now() - config.started; var passed = config.stats.all - config.stats.bad; if (config.stats.all === 0) { if (config.filter && config.filter.length) { throw new Error("No tests matched the filter \"" + config.filter + "\"."); } if (config.module && config.module.length) { throw new Error("No tests matched the module \"" + config.module + "\"."); } if (config.moduleId && config.moduleId.length) { throw new Error("No tests matched the moduleId \"" + config.moduleId + "\"."); } if (config.testId && config.testId.length) { throw new Error("No tests matched the testId \"" + config.testId + "\"."); } throw new Error("No tests were run."); } emit("runEnd", globalSuite.end(true)); runLoggingCallbacks("done", { passed: passed, failed: config.stats.bad, total: config.stats.all, runtime: runtime }).then(function () { // Clear own storage items if all tests passed if (storage && config.stats.bad === 0) { for (var i = storage.length - 1; i >= 0; i--) { var key = storage.key(i); if (key.indexOf("qunit-test-") === 0) { storage.removeItem(key); } } } }); } var ProcessingQueue = { finished: false, add: addToTestQueue, advance: advance, taskCount: taskQueueLength }; var TestReport = function () { function TestReport(name, suite, options) { classCallCheck(this, TestReport); this.name = name; this.suiteName = suite.name; this.fullName = suite.fullName.concat(name); this.runtime = 0; this.assertions = []; this.skipped = !!options.skip; this.todo = !!options.todo; this.valid = options.valid; this._startTime = 0; this._endTime = 0; suite.pushTest(this); } createClass(TestReport, [{ key: "start", value: function start(recordTime) { if (recordTime) { this._startTime = performanceNow(); if (performance) { performance.mark("qunit_test_start"); } } return { name: this.name, suiteName: this.suiteName, fullName: this.fullName.slice() }; } }, { key: "end", value: function end(recordTime) { if (recordTime) { this._endTime = performanceNow(); if (performance) { performance.mark("qunit_test_end"); var testName = this.fullName.join(" – "); measure("QUnit Test: " + testName, "qunit_test_start", "qunit_test_end"); } } return extend(this.start(), { runtime: this.getRuntime(), status: this.getStatus(), errors: this.getFailedAssertions(), assertions: this.getAssertions() }); } }, { key: "pushAssertion", value: function pushAssertion(assertion) { this.assertions.push(assertion); } }, { key: "getRuntime", value: function getRuntime() { return this._endTime - this._startTime; } }, { key: "getStatus", value: function getStatus() { if (this.skipped) { return "skipped"; } var testPassed = this.getFailedAssertions().length > 0 ? this.todo : !this.todo; if (!testPassed) { return "failed"; } else if (this.todo) { return "todo"; } else { return "passed"; } } }, { key: "getFailedAssertions", value: function getFailedAssertions() { return this.assertions.filter(function (assertion) { return !assertion.passed; }); } }, { key: "getAssertions", value: function getAssertions() { return this.assertions.slice(); } // Remove actual and expected values from assertions. This is to prevent // leaking memory throughout a test suite. }, { key: "slimAssertions", value: function slimAssertions() { this.assertions = this.assertions.map(function (assertion) { delete assertion.actual; delete assertion.expected; return assertion; }); } }]); return TestReport; }(); var focused$1 = false; function Test(settings) { var i, l; ++Test.count; this.expected = null; this.assertions = []; this.semaphore = 0; this.module = config.currentModule; this.stack = sourceFromStacktrace(3); this.steps = []; this.timeout = undefined; // If a module is skipped, all its tests and the tests of the child suites // should be treated as skipped even if they are defined as `only` or `todo`. // As for `todo` module, all its tests will be treated as `todo` except for // tests defined as `skip` which will be left intact. // // So, if a test is defined as `todo` and is inside a skipped module, we should // then treat that test as if was defined as `skip`. if (this.module.skip) { settings.skip = true; settings.todo = false; // Skipped tests should be left intact } else if (this.module.todo && !settings.skip) { settings.todo = true; } extend(this, settings); this.testReport = new TestReport(settings.testName, this.module.suiteReport, { todo: settings.todo, skip: settings.skip, valid: this.valid() }); // Register unique strings for (i = 0, l = this.module.tests; i < l.length; i++) { if (this.module.tests[i].name === this.testName) { this.testName += " "; } } this.testId = generateHash(this.module.name, this.testName); this.module.tests.push({ name: this.testName, testId: this.testId, skip: !!settings.skip }); if (settings.skip) { // Skipped tests will fully ignore any sent callback this.callback = function () {}; this.async = false; this.expected = 0; } else { if (typeof this.callback !== "function") { var method = this.todo ? "todo" : "test"; // eslint-disable-next-line max-len throw new TypeError("You must provide a function as a test callback to QUnit." + method + "(\"" + settings.testName + "\")"); } this.assert = new Assert(this); } } Test.count = 0; function getNotStartedModules(startModule) { var module = startModule, modules = []; while (module && module.testsRun === 0) { modules.push(module); module = module.parentModule; } // The above push modules from the child to the parent // return a reversed order with the top being the top most parent module return modules.reverse(); } Test.prototype = { before: function before() { var _this = this; var module = this.module, notStartedModules = getNotStartedModules(module); // ensure the callbacks are executed serially for each module var callbackPromises = notStartedModules.reduce(function (promiseChain, startModule) { return promiseChain.then(function () { startModule.stats = { all: 0, bad: 0, started: now() }; emit("suiteStart", startModule.suiteReport.start(true)); return runLoggingCallbacks("moduleStart", { name: startModule.name, tests: startModule.tests }); }); }, Promise$1.resolve([])); return callbackPromises.then(function () { config.current = _this; _this.testEnvironment = extend({}, module.testEnvironment); _this.started = now(); emit("testStart", _this.testReport.start(true)); return runLoggingCallbacks("testStart", { name: _this.testName, module: module.name, testId: _this.testId, previousFailure: _this.previousFailure }).then(function () { if (!config.pollution) { saveGlobal(); } }); }); }, run: function run() { var promise; config.current = this; this.callbackStarted = now(); if (config.notrycatch) { runTest(this); return; } try { runTest(this); } catch (e) { this.pushFailure("Died on test #" + (this.assertions.length + 1) + " " + this.stack + ": " + (e.message || e), extractStacktrace(e, 0)); // Else next test will carry the responsibility saveGlobal(); // Restart the tests if they're blocking if (config.blocking) { internalRecover(this); } } function runTest(test) { promise = test.callback.call(test.testEnvironment, test.assert); test.resolvePromise(promise); // If the test has a "lock" on it, but the timeout is 0, then we push a // failure as the test should be synchronous. if (test.timeout === 0 && test.semaphore !== 0) { pushFailure("Test did not finish synchronously even though assert.timeout( 0 ) was used.", sourceFromStacktrace(2)); } } }, after: function after() { checkPollution(); }, queueHook: function queueHook(hook, hookName, hookOwner) { var _this2 = this; var callHook = function callHook() { var promise = hook.call(_this2.testEnvironment, _this2.assert); _this2.resolvePromise(promise, hookName); }; var runHook = function runHook() { if (hookName === "before") { if (hookOwner.unskippedTestsRun !== 0) { return; } _this2.preserveEnvironment = true; } // The 'after' hook should only execute when there are not tests left and // when the 'after' and 'finish' tasks are the only tasks left to process if (hookName === "after" && hookOwner.unskippedTestsRun !== numberOfUnskippedTests(hookOwner) - 1 && (config.queue.length > 0 || ProcessingQueue.taskCount() > 2)) { return; } config.current = _this2; if (config.notrycatch) { callHook(); return; } try { callHook(); } catch (error) { _this2.pushFailure(hookName + " failed on " + _this2.testName + ": " + (error.message || error), extractStacktrace(error, 0)); } }; return runHook; }, // Currently only used for module level hooks, can be used to add global level ones hooks: function hooks(handler) { var hooks = []; function processHooks(test, module) { if (module.parentModule) { processHooks(test, module.parentModule); } if (module.hooks[handler].length) { for (var i = 0; i < module.hooks[handler].length; i++) { hooks.push(test.queueHook(module.hooks[handler][i], handler, module)); } } } // Hooks are ignored on skipped tests if (!this.skip) { processHooks(this, this.module); } return hooks; }, finish: function finish() { config.current = this; // Release the test callback to ensure that anything referenced has been // released to be garbage collected. this.callback = undefined; if (this.steps.length) { var stepsList = this.steps.join(", "); this.pushFailure("Expected assert.verifySteps() to be called before end of test " + ("after using assert.step(). Unverified steps: " + stepsList), this.stack); } if (config.requireExpects && this.expected === null) { this.pushFailure("Expected number of assertions to be defined, but expect() was " + "not called.", this.stack); } else if (this.expected !== null && this.expected !== this.assertions.length) { this.pushFailure("Expected " + this.expected + " assertions, but " + this.assertions.length + " were run", this.stack); } else if (this.expected === null && !this.assertions.length) { this.pushFailure("Expected at least one assertion, but none were run - call " + "expect(0) to accept zero assertions.", this.stack); } var i, module = this.module, moduleName = module.name, testName = this.testName, skipped = !!this.skip, todo = !!this.todo, bad = 0, storage = config.storage; this.runtime = now() - this.started; config.stats.all += this.assertions.length; module.stats.all += this.assertions.length; for (i = 0; i < this.assertions.length; i++) { if (!this.assertions[i].result) { bad++; config.stats.bad++; module.stats.bad++; } } notifyTestsRan(module, skipped); // Store result when possible if (storage) { if (bad) { storage.setItem("qunit-test-" + moduleName + "-" + testName, bad); } else { storage.removeItem("qunit-test-" + moduleName + "-" + testName); } } // After emitting the js-reporters event we cleanup the assertion data to // avoid leaking it. It is not used by the legacy testDone callbacks. emit("testEnd", this.testReport.end(true)); this.testReport.slimAssertions(); return runLoggingCallbacks("testDone", { name: testName, module: moduleName, skipped: skipped, todo: todo, failed: bad, passed: this.assertions.length - bad, total: this.assertions.length, runtime: skipped ? 0 : this.runtime, // HTML Reporter use assertions: this.assertions, testId: this.testId, // Source of Test source: this.stack }).then(function () { if (module.testsRun === numberOfTests(module)) { var completedModules = [module]; // Check if the parent modules, iteratively, are done. If that the case, // we emit the `suiteEnd` event and trigger `moduleDone` callback. var parent = module.parentModule; while (parent && parent.testsRun === numberOfTests(parent)) { completedModules.push(parent); parent = parent.parentModule; } return completedModules.reduce(function (promiseChain, completedModule) { return promiseChain.then(function () { return logSuiteEnd(completedModule); }); }, Promise$1.resolve([])); } }).then(function () { config.current = undefined; }); function logSuiteEnd(module) { // Reset `module.hooks` to ensure that anything referenced in these hooks // has been released to be garbage collected. module.hooks = {}; emit("suiteEnd", module.suiteReport.end(true)); return runLoggingCallbacks("moduleDone", { name: module.name, tests: module.tests, failed: module.stats.bad, passed: module.stats.all - module.stats.bad, total: module.stats.all, runtime: now() - module.stats.started }); } }, preserveTestEnvironment: function preserveTestEnvironment() { if (this.preserveEnvironment) { this.module.testEnvironment = this.testEnvironment; this.testEnvironment = extend({}, this.module.testEnvironment); } }, queue: function queue() { var test = this; if (!this.valid()) { return; } function runTest() { return [function () { return test.before(); }].concat(toConsumableArray(test.hooks("before")), [function () { test.preserveTestEnvironment(); }], toConsumableArray(test.hooks("beforeEach")), [function () { test.run(); }], toConsumableArray(test.hooks("afterEach").reverse()), toConsumableArray(test.hooks("after").reverse()), [function () { test.after(); }, function () { return test.finish(); }]); } var previousFailCount = config.storage && +config.storage.getItem("qunit-test-" + this.module.name + "-" + this.testName); // Prioritize previously failed tests, detected from storage var prioritize = config.reorder && !!previousFailCount; this.previousFailure = !!previousFailCount; ProcessingQueue.add(runTest, prioritize, config.seed); // If the queue has already finished, we manually process the new test if (ProcessingQueue.finished) { ProcessingQueue.advance(); } }, pushResult: function pushResult(resultInfo) { if (this !== config.current) { throw new Error("Assertion occurred after test had finished."); } // Destructure of resultInfo = { result, actual, expected, message, negative } var source, details = { module: this.module.name, name: this.testName, result: resultInfo.result, message: resultInfo.message, actual: resultInfo.actual, testId: this.testId, negative: resultInfo.negative || false, runtime: now() - this.started, todo: !!this.todo }; if (hasOwn.call(resultInfo, "expected")) { details.expected = resultInfo.expected; } if (!resultInfo.result) { source = resultInfo.source || sourceFromStacktrace(); if (source) { details.source = source; } } this.logAssertion(details); this.assertions.push({ result: !!resultInfo.result, message: resultInfo.message }); }, pushFailure: function pushFailure(message, source, actual) { if (!(this instanceof Test)) { throw new Error("pushFailure() assertion outside test context, was " + sourceFromStacktrace(2)); } this.pushResult({ result: false, message: message || "error", actual: actual || null, source: source }); }, /** * Log assertion details using both the old QUnit.log interface and * QUnit.on( "assertion" ) interface. * * @private */ logAssertion: function logAssertion(details) { runLoggingCallbacks("log", details); var assertion = { passed: details.result, actual: details.actual, expected: details.expected, message: details.message, stack: details.source, todo: details.todo }; this.testReport.pushAssertion(assertion); emit("assertion", assertion); }, resolvePromise: function resolvePromise(promise, phase) { var then, resume, message, test = this; if (promise != null) { then = promise.then; if (objectType(then) === "function") { resume = internalStop(test); if (config.notrycatch) { then.call(promise, function () { resume(); }); } else { then.call(promise, function () { resume(); }, function (error) { message = "Promise rejected " + (!phase ? "during" : phase.replace(/Each$/, "")) + " \"" + test.testName + "\": " + (error && error.message || error); test.pushFailure(message, extractStacktrace(error, 0)); // Else next test will carry the responsibility saveGlobal(); // Unblock internalRecover(test); }); } } } }, valid: function valid() { var filter = config.filter, regexFilter = /^(!?)\/([\w\W]*)\/(i?$)/.exec(filter), module = config.module && config.module.toLowerCase(), fullName = this.module.name + ": " + this.testName; function moduleChainNameMatch(testModule) { var testModuleName = testModule.name ? testModule.name.toLowerCase() : null; if (testModuleName === module) { return true; } else if (testModule.parentModule) { return moduleChainNameMatch(testModule.parentModule); } else { return false; } } function moduleChainIdMatch(testModule) { return inArray(testModule.moduleId, config.moduleId) || testModule.parentModule && moduleChainIdMatch(testModule.parentModule); } // Internally-generated tests are always valid if (this.callback && this.callback.validTest) { return true; } if (config.moduleId && config.moduleId.length > 0 && !moduleChainIdMatch(this.module)) { return false; } if (config.testId && config.testId.length > 0 && !inArray(this.testId, config.testId)) { return false; } if (module && !moduleChainNameMatch(this.module)) { return false; } if (!filter) { return true; } return regexFilter ? this.regexFilter(!!regexFilter[1], regexFilter[2], regexFilter[3], fullName) : this.stringFilter(filter, fullName); }, regexFilter: function regexFilter(exclude, pattern, flags, fullName) { var regex = new RegExp(pattern, flags); var match = regex.test(fullName); return match !== exclude; }, stringFilter: function stringFilter(filter, fullName) { filter = filter.toLowerCase(); fullName = fullName.toLowerCase(); var include = filter.charAt(0) !== "!"; if (!include) { filter = filter.slice(1); } // If the filter matches, we need to honour include if (fullName.indexOf(filter) !== -1) { return include; } // Otherwise, do the opposite return !include; } }; function pushFailure() { if (!config.current) { throw new Error("pushFailure() assertion outside test context, in " + sourceFromStacktrace(2)); } // Gets current test obj var currentTest = config.current; return currentTest.pushFailure.apply(currentTest, arguments); } function saveGlobal() { config.pollution = []; if (config.noglobals) { for (var key in global$1) { if (hasOwn.call(global$1, key)) { // In Opera sometimes DOM element ids show up here, ignore them if (/^qunit-test-output/.test(key)) { continue; } config.pollution.push(key); } } } } function checkPollution() { var newGlobals, deletedGlobals, old = config.pollution; saveGlobal(); newGlobals = diff(config.pollution, old); if (newGlobals.length > 0) { pushFailure("Introduced global variable(s): " + newGlobals.join(", ")); } deletedGlobals = diff(old, config.pollution); if (deletedGlobals.length > 0) { pushFailure("Deleted global variable(s): " + deletedGlobals.join(", ")); } } // Will be exposed as QUnit.test function test(testName, callback) { if (focused$1) { return; } var newTest = new Test({ testName: testName, callback: callback }); newTest.queue(); } function todo(testName, callback) { if (focused$1) { return; } var newTest = new Test({ testName: testName, callback: callback, todo: true }); newTest.queue(); } // Will be exposed as QUnit.skip function skip(testName) { if (focused$1) { return; } var test = new Test({ testName: testName, skip: true }); test.queue(); } // Will be exposed as QUnit.only function only(testName, callback) { if (focused$1) { return; } config.queue.length = 0; focused$1 = true; var newTest = new Test({ testName: testName, callback: callback }); newTest.queue(); } // Put a hold on processing and return a function that will release it. function internalStop(test) { var released = false; test.semaphore += 1; config.blocking = true; // Set a recovery timeout, if so configured. if (defined.setTimeout) { var timeoutDuration = void 0; if (typeof test.timeout === "number") { timeoutDuration = test.timeout; } else if (typeof config.testTimeout === "number") { timeoutDuration = config.testTimeout; } if (typeof timeoutDuration === "number" && timeoutDuration > 0) { clearTimeout(config.timeout); config.timeout = setTimeout$1(function () { pushFailure("Test took longer than " + timeoutDuration + "ms; test timed out.", sourceFromStacktrace(2)); released = true; internalRecover(test); }, timeoutDuration); } } return function resume() { if (released) { return; } released = true; test.semaphore -= 1; internalStart(test); }; } // Forcefully release all processing holds. function internalRecover(test) { test.semaphore = 0; internalStart(test); } // Release a processing hold, scheduling a resumption attempt if no holds remain. function internalStart(test) { // If semaphore is non-numeric, throw error if (isNaN(test.semaphore)) { test.semaphore = 0; pushFailure("Invalid value on test.semaphore", sourceFromStacktrace(2)); return; } // Don't start until equal number of stop-calls if (test.semaphore > 0) { return; } // Throw an Error if start is called more often than stop if (test.semaphore < 0) { test.semaphore = 0; pushFailure("Tried to restart test while already started (test's semaphore was 0 already)", sourceFromStacktrace(2)); return; } // Add a slight delay to allow more assertions etc. if (defined.setTimeout) { if (config.timeout) { clearTimeout(config.timeout); } config.timeout = setTimeout$1(function () { if (test.semaphore > 0) { return; } if (config.timeout) { clearTimeout(config.timeout); } begin(); }); } else { begin(); } } function collectTests(module) { var tests = [].concat(module.tests); var modules = [].concat(toConsumableArray(module.childModules)); // Do a breadth-first traversal of the child modules while (modules.length) { var nextModule = modules.shift(); tests.push.apply(tests, nextModule.tests); modules.push.apply(modules, toConsumableArray(nextModule.childModules)); } return tests; } function numberOfTests(module) { return collectTests(module).length; } function numberOfUnskippedTests(module) { return collectTests(module).filter(function (test) { return !test.skip; }).length; } function notifyTestsRan(module, skipped) { module.testsRun++; if (!skipped) { module.unskippedTestsRun++; } while (module = module.parentModule) { module.testsRun++; if (!skipped) { module.unskippedTestsRun++; } } } var Assert = function () { function Assert(testContext) { classCallCheck(this, Assert); this.test = testContext; } // Assert helpers createClass(Assert, [{ key: "timeout", value: function timeout(duration) { if (typeof duration !== "number") { throw new Error("You must pass a number as the duration to assert.timeout"); } this.test.timeout = duration; } // Documents a "step", which is a string value, in a test as a passing assertion }, { key: "step", value: function step(message) { var assertionMessage = message; var result = !!message; this.test.steps.push(message); if (objectType(message) === "undefined" || message === "") { assertionMessage = "You must provide a message to assert.step"; } else if (objectType(message) !== "string") { assertionMessage = "You must provide a string value to assert.step"; result = false; } this.pushResult({ result: result, message: assertionMessage }); } // Verifies the steps in a test match a given array of string values }, { key: "verifySteps", value: function verifySteps(steps, message) { // Since the steps array is just string values, we can clone with slice var actualStepsClone = this.test.steps.slice(); this.deepEqual(actualStepsClone, steps, message); this.test.steps.length = 0; } // Specify the number of expected assertions to guarantee that failed test // (no assertions are run at all) don't slip through. }, { key: "expect", value: function expect(asserts) { if (arguments.length === 1) { this.test.expected = asserts; } else { return this.test.expected; } } // Put a hold on processing and return a function that will release it a maximum of once. }, { key: "async", value: function async(count) { var test$$1 = this.test; var popped = false, acceptCallCount = count; if (typeof acceptCallCount === "undefined") { acceptCallCount = 1; } var resume = internalStop(test$$1); return function done() { if (config.current !== test$$1) { throw Error("assert.async callback called after test finished."); } if (popped) { test$$1.pushFailure("Too many calls to the `assert.async` callback", sourceFromStacktrace(2)); return; } acceptCallCount -= 1; if (acceptCallCount > 0) { return; } popped = true; resume(); }; } // Exports test.push() to the user API // Alias of pushResult. }, { key: "push", value: function push(result, actual, expected, message, negative) { Logger.warn("assert.push is deprecated and will be removed in QUnit 3.0." + " Please use assert.pushResult instead (https://api.qunitjs.com/assert/pushResult)."); var currentAssert = this instanceof Assert ? this : config.current.assert; return currentAssert.pushResult({ result: result, actual: actual, expected: expected, message: message, negative: negative }); } }, { key: "pushResult", value: function pushResult(resultInfo) { // Destructure of resultInfo = { result, actual, expected, message, negative } var assert = this; var currentTest = assert instanceof Assert && assert.test || config.current; // Backwards compatibility fix. // Allows the direct use of global exported assertions and QUnit.assert.* // Although, it's use is not recommended as it can leak assertions // to other tests from async tests, because we only get a reference to the current test, // not exactly the test where assertion were intended to be called. if (!currentTest) { throw new Error("assertion outside test context, in " + sourceFromStacktrace(2)); } if (!(assert instanceof Assert)) { assert = currentTest.assert; } return assert.test.pushResult(resultInfo); } }, { key: "ok", value: function ok(result, message) { if (!message) { message = result ? "okay" : "failed, expected argument to be truthy, was: " + dump.parse(result); } this.pushResult({ result: !!result, actual: result, expected: true, message: message }); } }, { key: "notOk", value: function notOk(result, message) { if (!message) { message = !result ? "okay" : "failed, expected argument to be falsy, was: " + dump.parse(result); } this.pushResult({ result: !result, actual: result, expected: false, message: message }); } }, { key: "equal", value: function equal(actual, expected, message) { // eslint-disable-next-line eqeqeq var result = expected == actual; this.pushResult({ result: result, actual: actual, expected: expected, message: message }); } }, { key: "notEqual", value: function notEqual(actual, expected, message) { // eslint-disable-next-line eqeqeq var result = expected != actual; this.pushResult({ result: result, actual: actual, expected: expected, message: message, negative: true }); } }, { key: "propEqual", value: function propEqual(actual, expected, message) { actual = objectValues(actual); expected = objectValues(expected); this.pushResult({ result: equiv(actual, expected), actual: actual, expected: expected, message: message }); } }, { key: "notPropEqual", value: function notPropEqual(actual, expected, message) { actual = objectValues(actual); expected = objectValues(expected); this.pushResult({ result: !equiv(actual, expected), actual: actual, expected: expected, message: message, negative: true }); } }, { key: "deepEqual", value: function deepEqual(actual, expected, message) { this.pushResult({ result: equiv(actual, expected), actual: actual, expected: expected, message: message }); } }, { key: "notDeepEqual", value: function notDeepEqual(actual, expected, message) { this.pushResult({ result: !equiv(actual, expected), actual: actual, expected: expected, message: message, negative: true }); } }, { key: "strictEqual", value: function strictEqual(actual, expected, message) { this.pushResult({ result: expected === actual, actual: actual, expected: expected, message: message }); } }, { key: "notStrictEqual", value: function notStrictEqual(actual, expected, message) { this.pushResult({ result: expected !== actual, actual: actual, expected: expected, message: message, negative: true }); } }, { key: "throws", value: function throws(block, expected, message) { var actual = void 0, result = false; var currentTest = this instanceof Assert && this.test || config.current; // 'expected' is optional unless doing string comparison if (objectType(expected) === "string") { if (message == null) { message = expected; expected = null; } else { throw new Error("throws/raises does not accept a string value for the expected argument.\n" + "Use a non-string object value (e.g. regExp) instead if it's necessary."); } } currentTest.ignoreGlobalErrors = true; try { block.call(currentTest.testEnvironment); } catch (e) { actual = e; } currentTest.ignoreGlobalErrors = false; if (actual) { var expectedType = objectType(expected); // We don't want to validate thrown error if (!expected) { result = true; // Expected is a regexp } else if (expectedType === "regexp") { result = expected.test(errorString(actual)); // Log the string form of the regexp expected = String(expected); // Expected is a constructor, maybe an Error constructor } else if (expectedType === "function" && actual instanceof expected) { result = true; // Expected is an Error object } else if (expectedType === "object") { result = actual instanceof expected.constructor && actual.name === expected.name && actual.message === expected.message; // Log the string form of the Error object expected = errorString(expected); // Expected is a validation function which returns true if validation passed } else if (expectedType === "function" && expected.call({}, actual) === true) { expected = null; result = true; } } currentTest.assert.pushResult({ result: result, // undefined if it didn't throw actual: actual && errorString(actual), expected: expected, message: message }); } }, { key: "rejects", value: function rejects(promise, expected, message) { var result = false; var currentTest = this instanceof Assert && this.test || config.current; // 'expected' is optional unless doing string comparison if (objectType(expected) === "string") { if (message === undefined) { message = expected; expected = undefined; } else { message = "assert.rejects does not accept a string value for the expected " + "argument.\nUse a non-string object value (e.g. validator function) instead " + "if necessary."; currentTest.assert.pushResult({ result: false, message: message }); return; } } var then = promise && promise.then; if (objectType(then) !== "function") { var _message = "The value provided to `assert.rejects` in " + "\"" + currentTest.testName + "\" was not a promise."; currentTest.assert.pushResult({ result: false, message: _message, actual: promise }); return; } var done = this.async(); return then.call(promise, function handleFulfillment() { var message = "The promise returned by the `assert.rejects` callback in " + "\"" + currentTest.testName + "\" did not reject."; currentTest.assert.pushResult({ result: false, message: message, actual: promise }); done(); }, function handleRejection(actual) { var expectedType = objectType(expected); // We don't want to validate if (expected === undefined) { result = true; // Expected is a regexp } else if (expectedType === "regexp") { result = expected.test(errorString(actual)); // Log the string form of the regexp expected = String(expected); // Expected is a constructor, maybe an Error constructor } else if (expectedType === "function" && actual instanceof expected) { result = true; // Expected is an Error object } else if (expectedType === "object") { result = actual instanceof expected.constructor && actual.name === expected.name && actual.message === expected.message; // Log the string form of the Error object expected = errorString(expected); // Expected is a validation function which returns true if validation passed } else { if (expectedType === "function") { result = expected.call({}, actual) === true; expected = null; // Expected is some other invalid type } else { result = false; message = "invalid expected value provided to `assert.rejects` " + "callback in \"" + currentTest.testName + "\": " + expectedType + "."; } } currentTest.assert.pushResult({ result: result, // leave rejection value of undefined as-is actual: actual && errorString(actual), expected: expected, message: message }); done(); }); } }]); return Assert; }(); // Provide an alternative to assert.throws(), for environments that consider throws a reserved word // Known to us are: Closure Compiler, Narwhal // eslint-disable-next-line dot-notation Assert.prototype.raises = Assert.prototype["throws"]; /** * Converts an error into a simple string for comparisons. * * @param {Error|Object} error * @return {String} */ function errorString(error) { var resultErrorString = error.toString(); // If the error wasn't a subclass of Error but something like // an object literal with name and message properties... if (resultErrorString.substring(0, 7) === "[object") { var name = error.name ? error.name.toString() : "Error"; var message = error.message ? error.message.toString() : ""; if (name && message) { return name + ": " + message; } else if (name) { return name; } else if (message) { return message; } else { return "Error"; } } else { return resultErrorString; } } /* global module, exports, define */ function exportQUnit(QUnit) { if (defined.document) { // QUnit may be defined when it is preconfigured but then only QUnit and QUnit.config may be defined. if (window$1.QUnit && window$1.QUnit.version) { throw new Error("QUnit has already been defined."); } window$1.QUnit = QUnit; } // For nodejs if (typeof module !== "undefined" && module && module.exports) { module.exports = QUnit; // For consistency with CommonJS environments' exports module.exports.QUnit = QUnit; } // For CommonJS with exports, but without module.exports, like Rhino if (typeof exports !== "undefined" && exports) { exports.QUnit = QUnit; } if (typeof define === "function" && define.amd) { define(function () { return QUnit; }); QUnit.config.autostart = false; } // For Web/Service Workers if (self$1 && self$1.WorkerGlobalScope && self$1 instanceof self$1.WorkerGlobalScope) { self$1.QUnit = QUnit; } } // Handle an unhandled exception. By convention, returns true if further // error handling should be suppressed and false otherwise. // In this case, we will only suppress further error handling if the // "ignoreGlobalErrors" configuration option is enabled. function onError(error) { for (var _len = arguments.length, args = Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) { args[_key - 1] = arguments[_key]; } if (config.current) { if (config.current.ignoreGlobalErrors) { return true; } pushFailure.apply(undefined, [error.message, error.stacktrace || error.fileName + ":" + error.lineNumber].concat(args)); } else { test("global failure", extend(function () { pushFailure.apply(undefined, [error.message, error.stacktrace || error.fileName + ":" + error.lineNumber].concat(args)); }, { validTest: true })); } return false; } // Handle an unhandled rejection function onUnhandledRejection(reason) { var resultInfo = { result: false, message: reason.message || "error", actual: reason, source: reason.stack || sourceFromStacktrace(3) }; var currentTest = config.current; if (currentTest) { currentTest.assert.pushResult(resultInfo); } else { test("global failure", extend(function (assert) { assert.pushResult(resultInfo); }, { validTest: true })); } } var QUnit = {}; var globalSuite = new SuiteReport(); // The initial "currentModule" represents the global (or top-level) module that // is not explicitly defined by the user, therefore we add the "globalSuite" to // it since each module has a suiteReport associated with it. config.currentModule.suiteReport = globalSuite; var globalStartCalled = false; var runStarted = false; // Figure out if we're running the tests from a server or not QUnit.isLocal = !(defined.document && window$1.location.protocol !== "file:"); // Expose the current QUnit version QUnit.version = "2.9.2"; extend(QUnit, { on: on, module: module$1, test: test, todo: todo, skip: skip, only: only, start: function start(count) { var globalStartAlreadyCalled = globalStartCalled; if (!config.current) { globalStartCalled = true; if (runStarted) { throw new Error("Called start() while test already started running"); } else if (globalStartAlreadyCalled || count > 1) { throw new Error("Called start() outside of a test context too many times"); } else if (config.autostart) { throw new Error("Called start() outside of a test context when " + "QUnit.config.autostart was true"); } else if (!config.pageLoaded) { // The page isn't completely loaded yet, so we set autostart and then // load if we're in Node or wait for the browser's load event. config.autostart = true; // Starts from Node even if .load was not previously called. We still return // early otherwise we'll wind up "beginning" twice. if (!defined.document) { QUnit.load(); } return; } } else { throw new Error("QUnit.start cannot be called inside a test context."); } scheduleBegin(); }, config: config, is: is, objectType: objectType, extend: extend, load: function load() { config.pageLoaded = true; // Initialize the configuration options extend(config, { stats: { all: 0, bad: 0 }, started: 0, updateRate: 1000, autostart: true, filter: "" }, true); if (!runStarted) { config.blocking = false; if (config.autostart) { scheduleBegin(); } } }, stack: function stack(offset) { offset = (offset || 0) + 2; return sourceFromStacktrace(offset); }, onError: onError, onUnhandledRejection: onUnhandledRejection }); QUnit.pushFailure = pushFailure; QUnit.assert = Assert.prototype; QUnit.equiv = equiv; QUnit.dump = dump; registerLoggingCallbacks(QUnit); function scheduleBegin() { runStarted = true; // Add a slight delay to allow definition of more modules and tests. if (defined.setTimeout) { setTimeout$1(function () { begin(); }); } else { begin(); } } function unblockAndAdvanceQueue() { config.blocking = false; ProcessingQueue.advance(); } function begin() { var i, l, modulesLog = []; // If the test run hasn't officially begun yet if (!config.started) { // Record the time of the test run's beginning config.started = now(); // Delete the loose unnamed module if unused. if (config.modules[0].name === "" && config.modules[0].tests.length === 0) { config.modules.shift(); } // Avoid unnecessary information by not logging modules' test environments for (i = 0, l = config.modules.length; i < l; i++) { modulesLog.push({ name: config.modules[i].name, tests: config.modules[i].tests }); } // The test run is officially beginning now emit("runStart", globalSuite.start(true)); runLoggingCallbacks("begin", { totalTests: Test.count, modules: modulesLog }).then(unblockAndAdvanceQueue); } else { unblockAndAdvanceQueue(); } } exportQUnit(QUnit); (function () { if (typeof window$1 === "undefined" || typeof document$1 === "undefined") { return; } var config = QUnit.config, hasOwn = Object.prototype.hasOwnProperty; // Stores fixture HTML for resetting later function storeFixture() { // Avoid overwriting user-defined values if (hasOwn.call(config, "fixture")) { return; } var fixture = document$1.getElementById("qunit-fixture"); if (fixture) { config.fixture = fixture.cloneNode(true); } } QUnit.begin(storeFixture); // Resets the fixture DOM element if available. function resetFixture() { if (config.fixture == null) { return; } var fixture = document$1.getElementById("qunit-fixture"); var resetFixtureType = _typeof(config.fixture); if (resetFixtureType === "string") { // support user defined values for `config.fixture` var newFixture = document$1.createElement("div"); newFixture.setAttribute("id", "qunit-fixture"); newFixture.innerHTML = config.fixture; fixture.parentNode.replaceChild(newFixture, fixture); } else { var clonedFixture = config.fixture.cloneNode(true); fixture.parentNode.replaceChild(clonedFixture, fixture); } } QUnit.testStart(resetFixture); })(); (function () { // Only interact with URLs via window.location var location = typeof window$1 !== "undefined" && window$1.location; if (!location) { return; } var urlParams = getUrlParams(); QUnit.urlParams = urlParams; // Match module/test by inclusion in an array QUnit.config.moduleId = [].concat(urlParams.moduleId || []); QUnit.config.testId = [].concat(urlParams.testId || []); // Exact case-insensitive match of the module name QUnit.config.module = urlParams.module; // Regular expression or case-insenstive substring match against "moduleName: testName" QUnit.config.filter = urlParams.filter; // Test order randomization if (urlParams.seed === true) { // Generate a random seed if the option is specified without a value QUnit.config.seed = Math.random().toString(36).slice(2); } else if (urlParams.seed) { QUnit.config.seed = urlParams.seed; } // Add URL-parameter-mapped config values with UI form rendering data QUnit.config.urlConfig.push({ id: "hidepassed", label: "Hide passed tests", tooltip: "Only show tests and assertions that fail. Stored as query-strings." }, { id: "noglobals", label: "Check for Globals", tooltip: "Enabling this will test if any test introduces new properties on the " + "global object (`window` in Browsers). Stored as query-strings." }, { id: "notrycatch", label: "No try-catch", tooltip: "Enabling this will run tests outside of a try-catch block. Makes debugging " + "exceptions in IE reasonable. Stored as query-strings." }); QUnit.begin(function () { var i, option, urlConfig = QUnit.config.urlConfig; for (i = 0; i < urlConfig.length; i++) { // Options can be either strings or objects with nonempty "id" properties option = QUnit.config.urlConfig[i]; if (typeof option !== "string") { option = option.id; } if (QUnit.config[option] === undefined) { QUnit.config[option] = urlParams[option]; } } }); function getUrlParams() { var i, param, name, value; var urlParams = Object.create(null); var params = location.search.slice(1).split("&"); var length = params.length; for (i = 0; i < length; i++) { if (params[i]) { param = params[i].split("="); name = decodeQueryParam(param[0]); // Allow just a key to turn on a flag, e.g., test.html?noglobals value = param.length === 1 || decodeQueryParam(param.slice(1).join("=")); if (name in urlParams) { urlParams[name] = [].concat(urlParams[name], value); } else { urlParams[name] = value; } } } return urlParams; } function decodeQueryParam(param) { return decodeURIComponent(param.replace(/\+/g, "%20")); } })(); var stats = { passedTests: 0, failedTests: 0, skippedTests: 0, todoTests: 0 }; // Escape text for attribute or text content. function escapeText(s) { if (!s) { return ""; } s = s + ""; // Both single quotes and double quotes (for attributes) return s.replace(/['"<>&]/g, function (s) { switch (s) { case "'": return "'"; case "\"": return """; case "<": return "<"; case ">": return ">"; case "&": return "&"; } }); } (function () { // Don't load the HTML Reporter on non-browser environments if (typeof window$1 === "undefined" || !window$1.document) { return; } var config = QUnit.config, hiddenTests = [], document = window$1.document, collapseNext = false, hasOwn = Object.prototype.hasOwnProperty, unfilteredUrl = setUrl({ filter: undefined, module: undefined, moduleId: undefined, testId: undefined }), modulesList = []; function addEvent(elem, type, fn) { elem.addEventListener(type, fn, false); } function removeEvent(elem, type, fn) { elem.removeEventListener(type, fn, false); } function addEvents(elems, type, fn) { var i = elems.length; while (i--) { addEvent(elems[i], type, fn); } } function hasClass(elem, name) { return (" " + elem.className + " ").indexOf(" " + name + " ") >= 0; } function addClass(elem, name) { if (!hasClass(elem, name)) { elem.className += (elem.className ? " " : "") + name; } } function toggleClass(elem, name, force) { if (force || typeof force === "undefined" && !hasClass(elem, name)) { addClass(elem, name); } else { removeClass(elem, name); } } function removeClass(elem, name) { var set = " " + elem.className + " "; // Class name may appear multiple times while (set.indexOf(" " + name + " ") >= 0) { set = set.replace(" " + name + " ", " "); } // Trim for prettiness elem.className = typeof set.trim === "function" ? set.trim() : set.replace(/^\s+|\s+$/g, ""); } function id(name) { return document.getElementById && document.getElementById(name); } function abortTests() { var abortButton = id("qunit-abort-tests-button"); if (abortButton) { abortButton.disabled = true; abortButton.innerHTML = "Aborting..."; } QUnit.config.queue.length = 0; return false; } function interceptNavigation(ev) { applyUrlParams(); if (ev && ev.preventDefault) { ev.preventDefault(); } return false; } function getUrlConfigHtml() { var i, j, val, escaped, escapedTooltip, selection = false, urlConfig = config.urlConfig, urlConfigHtml = ""; for (i = 0; i < urlConfig.length; i++) { // Options can be either strings or objects with nonempty "id" properties val = config.urlConfig[i]; if (typeof val === "string") { val = { id: val, label: val }; } escaped = escapeText(val.id); escapedTooltip = escapeText(val.tooltip); if (!val.value || typeof val.value === "string") { urlConfigHtml += ""; } else { urlConfigHtml += ""; } } return urlConfigHtml; } // Handle "click" events on toolbar checkboxes and "change" for select menus. // Updates the URL with the new state of `config.urlConfig` values. function toolbarChanged() { var updatedUrl, value, tests, field = this, params = {}; // Detect if field is a select menu or a checkbox if ("selectedIndex" in field) { value = field.options[field.selectedIndex].value || undefined; } else { value = field.checked ? field.defaultValue || true : undefined; } params[field.name] = value; updatedUrl = setUrl(params); // Check if we can apply the change without a page refresh if ("hidepassed" === field.name && "replaceState" in window$1.history) { QUnit.urlParams[field.name] = value; config[field.name] = value || false; tests = id("qunit-tests"); if (tests) { var length = tests.children.length; var children = tests.children; if (field.checked) { for (var i = 0; i < length; i++) { var test = children[i]; if (test && test.className.indexOf("pass") > -1) { hiddenTests.push(test); } } var _iteratorNormalCompletion = true; var _didIteratorError = false; var _iteratorError = undefined; try { for (var _iterator = hiddenTests[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) { var hiddenTest = _step.value; tests.removeChild(hiddenTest); } } catch (err) { _didIteratorError = true; _iteratorError = err; } finally { try { if (!_iteratorNormalCompletion && _iterator.return) { _iterator.return(); } } finally { if (_didIteratorError) { throw _iteratorError; } } } } else { while ((test = hiddenTests.pop()) != null) { tests.appendChild(test); } } } window$1.history.replaceState(null, "", updatedUrl); } else { window$1.location = updatedUrl; } } function setUrl(params) { var key, arrValue, i, querystring = "?", location = window$1.location; params = QUnit.extend(QUnit.extend({}, QUnit.urlParams), params); for (key in params) { // Skip inherited or undefined properties if (hasOwn.call(params, key) && params[key] !== undefined) { // Output a parameter for each value of this key // (but usually just one) arrValue = [].concat(params[key]); for (i = 0; i < arrValue.length; i++) { querystring += encodeURIComponent(key); if (arrValue[i] !== true) { querystring += "=" + encodeURIComponent(arrValue[i]); } querystring += "&"; } } } return location.protocol + "//" + location.host + location.pathname + querystring.slice(0, -1); } function applyUrlParams() { var i, selectedModules = [], modulesList = id("qunit-modulefilter-dropdown-list").getElementsByTagName("input"), filter = id("qunit-filter-input").value; for (i = 0; i < modulesList.length; i++) { if (modulesList[i].checked) { selectedModules.push(modulesList[i].value); } } window$1.location = setUrl({ filter: filter === "" ? undefined : filter, moduleId: selectedModules.length === 0 ? undefined : selectedModules, // Remove module and testId filter module: undefined, testId: undefined }); } function toolbarUrlConfigContainer() { var urlConfigContainer = document.createElement("span"); urlConfigContainer.innerHTML = getUrlConfigHtml(); addClass(urlConfigContainer, "qunit-url-config"); addEvents(urlConfigContainer.getElementsByTagName("input"), "change", toolbarChanged); addEvents(urlConfigContainer.getElementsByTagName("select"), "change", toolbarChanged); return urlConfigContainer; } function abortTestsButton() { var button = document.createElement("button"); button.id = "qunit-abort-tests-button"; button.innerHTML = "Abort"; addEvent(button, "click", abortTests); return button; } function toolbarLooseFilter() { var filter = document.createElement("form"), label = document.createElement("label"), input = document.createElement("input"), button = document.createElement("button"); addClass(filter, "qunit-filter"); label.innerHTML = "Filter: "; input.type = "text"; input.value = config.filter || ""; input.name = "filter"; input.id = "qunit-filter-input"; button.innerHTML = "Go"; label.appendChild(input); filter.appendChild(label); filter.appendChild(document.createTextNode(" ")); filter.appendChild(button); addEvent(filter, "submit", interceptNavigation); return filter; } function moduleListHtml() { var i, checked, html = ""; for (i = 0; i < config.modules.length; i++) { if (config.modules[i].name !== "") { checked = config.moduleId.indexOf(config.modules[i].moduleId) > -1; html += "
  • "; } } return html; } function toolbarModuleFilter() { var commit, reset, moduleFilter = document.createElement("form"), label = document.createElement("label"), moduleSearch = document.createElement("input"), dropDown = document.createElement("div"), actions = document.createElement("span"), applyButton = document.createElement("button"), resetButton = document.createElement("button"), allModulesLabel = document.createElement("label"), allCheckbox = document.createElement("input"), dropDownList = document.createElement("ul"), dirty = false; moduleSearch.id = "qunit-modulefilter-search"; moduleSearch.autocomplete = "off"; addEvent(moduleSearch, "input", searchInput); addEvent(moduleSearch, "input", searchFocus); addEvent(moduleSearch, "focus", searchFocus); addEvent(moduleSearch, "click", searchFocus); label.id = "qunit-modulefilter-search-container"; label.innerHTML = "Module: "; label.appendChild(moduleSearch); applyButton.textContent = "Apply"; applyButton.style.display = "none"; resetButton.textContent = "Reset"; resetButton.type = "reset"; resetButton.style.display = "none"; allCheckbox.type = "checkbox"; allCheckbox.checked = config.moduleId.length === 0; allModulesLabel.className = "clickable"; if (config.moduleId.length) { allModulesLabel.className = "checked"; } allModulesLabel.appendChild(allCheckbox); allModulesLabel.appendChild(document.createTextNode("All modules")); actions.id = "qunit-modulefilter-actions"; actions.appendChild(applyButton); actions.appendChild(resetButton); actions.appendChild(allModulesLabel); commit = actions.firstChild; reset = commit.nextSibling; addEvent(commit, "click", applyUrlParams); dropDownList.id = "qunit-modulefilter-dropdown-list"; dropDownList.innerHTML = moduleListHtml(); dropDown.id = "qunit-modulefilter-dropdown"; dropDown.style.display = "none"; dropDown.appendChild(actions); dropDown.appendChild(dropDownList); addEvent(dropDown, "change", selectionChange); selectionChange(); moduleFilter.id = "qunit-modulefilter"; moduleFilter.appendChild(label); moduleFilter.appendChild(dropDown); addEvent(moduleFilter, "submit", interceptNavigation); addEvent(moduleFilter, "reset", function () { // Let the reset happen, then update styles window$1.setTimeout(selectionChange); }); // Enables show/hide for the dropdown function searchFocus() { if (dropDown.style.display !== "none") { return; } dropDown.style.display = "block"; addEvent(document, "click", hideHandler); addEvent(document, "keydown", hideHandler); // Hide on Escape keydown or outside-container click function hideHandler(e) { var inContainer = moduleFilter.contains(e.target); if (e.keyCode === 27 || !inContainer) { if (e.keyCode === 27 && inContainer) { moduleSearch.focus(); } dropDown.style.display = "none"; removeEvent(document, "click", hideHandler); removeEvent(document, "keydown", hideHandler); moduleSearch.value = ""; searchInput(); } } } // Processes module search box input function searchInput() { var i, item, searchText = moduleSearch.value.toLowerCase(), listItems = dropDownList.children; for (i = 0; i < listItems.length; i++) { item = listItems[i]; if (!searchText || item.textContent.toLowerCase().indexOf(searchText) > -1) { item.style.display = ""; } else { item.style.display = "none"; } } } // Processes selection changes function selectionChange(evt) { var i, item, checkbox = evt && evt.target || allCheckbox, modulesList = dropDownList.getElementsByTagName("input"), selectedNames = []; toggleClass(checkbox.parentNode, "checked", checkbox.checked); dirty = false; if (checkbox.checked && checkbox !== allCheckbox) { allCheckbox.checked = false; removeClass(allCheckbox.parentNode, "checked"); } for (i = 0; i < modulesList.length; i++) { item = modulesList[i]; if (!evt) { toggleClass(item.parentNode, "checked", item.checked); } else if (checkbox === allCheckbox && checkbox.checked) { item.checked = false; removeClass(item.parentNode, "checked"); } dirty = dirty || item.checked !== item.defaultChecked; if (item.checked) { selectedNames.push(item.parentNode.textContent); } } commit.style.display = reset.style.display = dirty ? "" : "none"; moduleSearch.placeholder = selectedNames.join(", ") || allCheckbox.parentNode.textContent; moduleSearch.title = "Type to filter list. Current selection:\n" + (selectedNames.join("\n") || allCheckbox.parentNode.textContent); } return moduleFilter; } function appendToolbar() { var toolbar = id("qunit-testrunner-toolbar"); if (toolbar) { toolbar.appendChild(toolbarUrlConfigContainer()); toolbar.appendChild(toolbarModuleFilter()); toolbar.appendChild(toolbarLooseFilter()); toolbar.appendChild(document.createElement("div")).className = "clearfix"; } } function appendHeader() { var header = id("qunit-header"); if (header) { header.innerHTML = "" + header.innerHTML + " "; } } function appendBanner() { var banner = id("qunit-banner"); if (banner) { banner.className = ""; } } function appendTestResults() { var tests = id("qunit-tests"), result = id("qunit-testresult"), controls; if (result) { result.parentNode.removeChild(result); } if (tests) { tests.innerHTML = ""; result = document.createElement("p"); result.id = "qunit-testresult"; result.className = "result"; tests.parentNode.insertBefore(result, tests); result.innerHTML = "
    Running...
     
    " + "
    " + "
    "; controls = id("qunit-testresult-controls"); } if (controls) { controls.appendChild(abortTestsButton()); } } function appendFilteredTest() { var testId = QUnit.config.testId; if (!testId || testId.length <= 0) { return ""; } return "
    Rerunning selected tests: " + escapeText(testId.join(", ")) + " Run all tests
    "; } function appendUserAgent() { var userAgent = id("qunit-userAgent"); if (userAgent) { userAgent.innerHTML = ""; userAgent.appendChild(document.createTextNode("QUnit " + QUnit.version + "; " + navigator.userAgent)); } } function appendInterface() { var qunit = id("qunit"); if (qunit) { qunit.innerHTML = "

    " + escapeText(document.title) + "

    " + "

    " + "
    " + appendFilteredTest() + "

    " + "
      "; } appendHeader(); appendBanner(); appendTestResults(); appendUserAgent(); appendToolbar(); } function appendTest(name, testId, moduleName) { var title, rerunTrigger, testBlock, assertList, tests = id("qunit-tests"); if (!tests) { return; } title = document.createElement("strong"); title.innerHTML = getNameHtml(name, moduleName); rerunTrigger = document.createElement("a"); rerunTrigger.innerHTML = "Rerun"; rerunTrigger.href = setUrl({ testId: testId }); testBlock = document.createElement("li"); testBlock.appendChild(title); testBlock.appendChild(rerunTrigger); testBlock.id = "qunit-test-output-" + testId; assertList = document.createElement("ol"); assertList.className = "qunit-assert-list"; testBlock.appendChild(assertList); tests.appendChild(testBlock); } // HTML Reporter initialization and load QUnit.begin(function (details) { var i, moduleObj; // Sort modules by name for the picker for (i = 0; i < details.modules.length; i++) { moduleObj = details.modules[i]; if (moduleObj.name) { modulesList.push(moduleObj.name); } } modulesList.sort(function (a, b) { return a.localeCompare(b); }); // Initialize QUnit elements appendInterface(); }); QUnit.done(function (details) { var banner = id("qunit-banner"), tests = id("qunit-tests"), abortButton = id("qunit-abort-tests-button"), totalTests = stats.passedTests + stats.skippedTests + stats.todoTests + stats.failedTests, html = [totalTests, " tests completed in ", details.runtime, " milliseconds, with ", stats.failedTests, " failed, ", stats.skippedTests, " skipped, and ", stats.todoTests, " todo.
      ", "", details.passed, " assertions of ", details.total, " passed, ", details.failed, " failed."].join(""), test, assertLi, assertList; // Update remaing tests to aborted if (abortButton && abortButton.disabled) { html = "Tests aborted after " + details.runtime + " milliseconds."; for (var i = 0; i < tests.children.length; i++) { test = tests.children[i]; if (test.className === "" || test.className === "running") { test.className = "aborted"; assertList = test.getElementsByTagName("ol")[0]; assertLi = document.createElement("li"); assertLi.className = "fail"; assertLi.innerHTML = "Test aborted."; assertList.appendChild(assertLi); } } } if (banner && (!abortButton || abortButton.disabled === false)) { banner.className = stats.failedTests ? "qunit-fail" : "qunit-pass"; } if (abortButton) { abortButton.parentNode.removeChild(abortButton); } if (tests) { id("qunit-testresult-display").innerHTML = html; } if (config.altertitle && document.title) { // Show ✖ for good, ✔ for bad suite result in title // use escape sequences in case file gets loaded with non-utf-8 // charset document.title = [stats.failedTests ? "\u2716" : "\u2714", document.title.replace(/^[\u2714\u2716] /i, "")].join(" "); } // Scroll back to top to show results if (config.scrolltop && window$1.scrollTo) { window$1.scrollTo(0, 0); } }); function getNameHtml(name, module) { var nameHtml = ""; if (module) { nameHtml = "" + escapeText(module) + ": "; } nameHtml += "" + escapeText(name) + ""; return nameHtml; } QUnit.testStart(function (details) { var running, bad; appendTest(details.name, details.testId, details.module); running = id("qunit-testresult-display"); if (running) { addClass(running, "running"); bad = QUnit.config.reorder && details.previousFailure; running.innerHTML = [bad ? "Rerunning previously failed test:
      " : "Running:
      ", getNameHtml(details.name, details.module)].join(""); } }); function stripHtml(string) { // Strip tags, html entity and whitespaces return string.replace(/<\/?[^>]+(>|$)/g, "").replace(/"/g, "").replace(/\s+/g, ""); } QUnit.log(function (details) { var assertList, assertLi, message, expected, actual, diff, showDiff = false, testItem = id("qunit-test-output-" + details.testId); if (!testItem) { return; } message = escapeText(details.message) || (details.result ? "okay" : "failed"); message = "" + message + ""; message += "@ " + details.runtime + " ms"; // The pushFailure doesn't provide details.expected // when it calls, it's implicit to also not show expected and diff stuff // Also, we need to check details.expected existence, as it can exist and be undefined if (!details.result && hasOwn.call(details, "expected")) { if (details.negative) { expected = "NOT " + QUnit.dump.parse(details.expected); } else { expected = QUnit.dump.parse(details.expected); } actual = QUnit.dump.parse(details.actual); message += ""; if (actual !== expected) { message += ""; if (typeof details.actual === "number" && typeof details.expected === "number") { if (!isNaN(details.actual) && !isNaN(details.expected)) { showDiff = true; diff = details.actual - details.expected; diff = (diff > 0 ? "+" : "") + diff; } } else if (typeof details.actual !== "boolean" && typeof details.expected !== "boolean") { diff = QUnit.diff(expected, actual); // don't show diff if there is zero overlap showDiff = stripHtml(diff).length !== stripHtml(expected).length + stripHtml(actual).length; } if (showDiff) { message += ""; } } else if (expected.indexOf("[object Array]") !== -1 || expected.indexOf("[object Object]") !== -1) { message += ""; } else { message += ""; } if (details.source) { message += ""; } message += "
      Expected:
      " + escapeText(expected) + "
      Result:
      " + escapeText(actual) + "
      Diff:
      " + diff + "
      Message: " + "Diff suppressed as the depth of object is more than current max depth (" + QUnit.config.maxDepth + ").

      Hint: Use QUnit.dump.maxDepth to " + " run with a higher max depth or " + "Rerun without max depth.

      Message: " + "Diff suppressed as the expected and actual results have an equivalent" + " serialization
      Source:
      " + escapeText(details.source) + "
      "; // This occurs when pushFailure is set and we have an extracted stack trace } else if (!details.result && details.source) { message += "" + "" + "
      Source:
      " + escapeText(details.source) + "
      "; } assertList = testItem.getElementsByTagName("ol")[0]; assertLi = document.createElement("li"); assertLi.className = details.result ? "pass" : "fail"; assertLi.innerHTML = message; assertList.appendChild(assertLi); }); QUnit.testDone(function (details) { var testTitle, time, testItem, assertList, status, good, bad, testCounts, skipped, sourceName, tests = id("qunit-tests"); if (!tests) { return; } testItem = id("qunit-test-output-" + details.testId); removeClass(testItem, "running"); if (details.failed > 0) { status = "failed"; } else if (details.todo) { status = "todo"; } else { status = details.skipped ? "skipped" : "passed"; } assertList = testItem.getElementsByTagName("ol")[0]; good = details.passed; bad = details.failed; // This test passed if it has no unexpected failed assertions var testPassed = details.failed > 0 ? details.todo : !details.todo; if (testPassed) { // Collapse the passing tests addClass(assertList, "qunit-collapsed"); } else if (config.collapse) { if (!collapseNext) { // Skip collapsing the first failing test collapseNext = true; } else { // Collapse remaining tests addClass(assertList, "qunit-collapsed"); } } // The testItem.firstChild is the test name testTitle = testItem.firstChild; testCounts = bad ? "" + bad + ", " + "" + good + ", " : ""; testTitle.innerHTML += " (" + testCounts + details.assertions.length + ")"; if (details.skipped) { stats.skippedTests++; testItem.className = "skipped"; skipped = document.createElement("em"); skipped.className = "qunit-skipped-label"; skipped.innerHTML = "skipped"; testItem.insertBefore(skipped, testTitle); } else { addEvent(testTitle, "click", function () { toggleClass(assertList, "qunit-collapsed"); }); testItem.className = testPassed ? "pass" : "fail"; if (details.todo) { var todoLabel = document.createElement("em"); todoLabel.className = "qunit-todo-label"; todoLabel.innerHTML = "todo"; testItem.className += " todo"; testItem.insertBefore(todoLabel, testTitle); } time = document.createElement("span"); time.className = "runtime"; time.innerHTML = details.runtime + " ms"; testItem.insertBefore(time, assertList); if (!testPassed) { stats.failedTests++; } else if (details.todo) { stats.todoTests++; } else { stats.passedTests++; } } // Show the source of the test when showing assertions if (details.source) { sourceName = document.createElement("p"); sourceName.innerHTML = "Source: " + escapeText(details.source); addClass(sourceName, "qunit-source"); if (testPassed) { addClass(sourceName, "qunit-collapsed"); } addEvent(testTitle, "click", function () { toggleClass(sourceName, "qunit-collapsed"); }); testItem.appendChild(sourceName); } if (config.hidepassed && status === "passed") { // use removeChild instead of remove because of support hiddenTests.push(testItem); tests.removeChild(testItem); } }); // Avoid readyState issue with phantomjs // Ref: #818 var notPhantom = function (p) { return !(p && p.version && p.version.major > 0); }(window$1.phantom); if (notPhantom && document.readyState === "complete") { QUnit.load(); } else { addEvent(window$1, "load", QUnit.load); } // Wrap window.onerror. We will call the original window.onerror to see if // the existing handler fully handles the error; if not, we will call the // QUnit.onError function. var originalWindowOnError = window$1.onerror; // Cover uncaught exceptions // Returning true will suppress the default browser handler, // returning false will let it run. window$1.onerror = function (message, fileName, lineNumber, columnNumber, errorObj) { var ret = false; if (originalWindowOnError) { for (var _len = arguments.length, args = Array(_len > 5 ? _len - 5 : 0), _key = 5; _key < _len; _key++) { args[_key - 5] = arguments[_key]; } ret = originalWindowOnError.call.apply(originalWindowOnError, [this, message, fileName, lineNumber, columnNumber, errorObj].concat(args)); } // Treat return value as window.onerror itself does, // Only do our handling if not suppressed. if (ret !== true) { var error = { message: message, fileName: fileName, lineNumber: lineNumber }; // According to // https://blog.sentry.io/2016/01/04/client-javascript-reporting-window-onerror, // most modern browsers support an errorObj argument; use that to // get a full stack trace if it's available. if (errorObj && errorObj.stack) { error.stacktrace = extractStacktrace(errorObj, 0); } ret = QUnit.onError(error); } return ret; }; // Listen for unhandled rejections, and call QUnit.onUnhandledRejection window$1.addEventListener("unhandledrejection", function (event) { QUnit.onUnhandledRejection(event.reason); }); })(); /* * This file is a modified version of google-diff-match-patch's JavaScript implementation * (https://code.google.com/p/google-diff-match-patch/source/browse/trunk/javascript/diff_match_patch_uncompressed.js), * modifications are licensed as more fully set forth in LICENSE.txt. * * The original source of google-diff-match-patch is attributable and licensed as follows: * * Copyright 2006 Google Inc. * https://code.google.com/p/google-diff-match-patch/ * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * https://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * * More Info: * https://code.google.com/p/google-diff-match-patch/ * * Usage: QUnit.diff(expected, actual) * */ QUnit.diff = function () { function DiffMatchPatch() {} // DIFF FUNCTIONS /** * The data structure representing a diff is an array of tuples: * [[DIFF_DELETE, 'Hello'], [DIFF_INSERT, 'Goodbye'], [DIFF_EQUAL, ' world.']] * which means: delete 'Hello', add 'Goodbye' and keep ' world.' */ var DIFF_DELETE = -1, DIFF_INSERT = 1, DIFF_EQUAL = 0; /** * Find the differences between two texts. Simplifies the problem by stripping * any common prefix or suffix off the texts before diffing. * @param {string} text1 Old string to be diffed. * @param {string} text2 New string to be diffed. * @param {boolean=} optChecklines Optional speedup flag. If present and false, * then don't run a line-level diff first to identify the changed areas. * Defaults to true, which does a faster, slightly less optimal diff. * @return {!Array.} Array of diff tuples. */ DiffMatchPatch.prototype.DiffMain = function (text1, text2, optChecklines) { var deadline, checklines, commonlength, commonprefix, commonsuffix, diffs; // The diff must be complete in up to 1 second. deadline = new Date().getTime() + 1000; // Check for null inputs. if (text1 === null || text2 === null) { throw new Error("Null input. (DiffMain)"); } // Check for equality (speedup). if (text1 === text2) { if (text1) { return [[DIFF_EQUAL, text1]]; } return []; } if (typeof optChecklines === "undefined") { optChecklines = true; } checklines = optChecklines; // Trim off common prefix (speedup). commonlength = this.diffCommonPrefix(text1, text2); commonprefix = text1.substring(0, commonlength); text1 = text1.substring(commonlength); text2 = text2.substring(commonlength); // Trim off common suffix (speedup). commonlength = this.diffCommonSuffix(text1, text2); commonsuffix = text1.substring(text1.length - commonlength); text1 = text1.substring(0, text1.length - commonlength); text2 = text2.substring(0, text2.length - commonlength); // Compute the diff on the middle block. diffs = this.diffCompute(text1, text2, checklines, deadline); // Restore the prefix and suffix. if (commonprefix) { diffs.unshift([DIFF_EQUAL, commonprefix]); } if (commonsuffix) { diffs.push([DIFF_EQUAL, commonsuffix]); } this.diffCleanupMerge(diffs); return diffs; }; /** * Reduce the number of edits by eliminating operationally trivial equalities. * @param {!Array.} diffs Array of diff tuples. */ DiffMatchPatch.prototype.diffCleanupEfficiency = function (diffs) { var changes, equalities, equalitiesLength, lastequality, pointer, preIns, preDel, postIns, postDel; changes = false; equalities = []; // Stack of indices where equalities are found. equalitiesLength = 0; // Keeping our own length var is faster in JS. /** @type {?string} */ lastequality = null; // Always equal to diffs[equalities[equalitiesLength - 1]][1] pointer = 0; // Index of current position. // Is there an insertion operation before the last equality. preIns = false; // Is there a deletion operation before the last equality. preDel = false; // Is there an insertion operation after the last equality. postIns = false; // Is there a deletion operation after the last equality. postDel = false; while (pointer < diffs.length) { // Equality found. if (diffs[pointer][0] === DIFF_EQUAL) { if (diffs[pointer][1].length < 4 && (postIns || postDel)) { // Candidate found. equalities[equalitiesLength++] = pointer; preIns = postIns; preDel = postDel; lastequality = diffs[pointer][1]; } else { // Not a candidate, and can never become one. equalitiesLength = 0; lastequality = null; } postIns = postDel = false; // An insertion or deletion. } else { if (diffs[pointer][0] === DIFF_DELETE) { postDel = true; } else { postIns = true; } /* * Five types to be split: * ABXYCD * AXCD * ABXC * AXCD * ABXC */ if (lastequality && (preIns && preDel && postIns && postDel || lastequality.length < 2 && preIns + preDel + postIns + postDel === 3)) { // Duplicate record. diffs.splice(equalities[equalitiesLength - 1], 0, [DIFF_DELETE, lastequality]); // Change second copy to insert. diffs[equalities[equalitiesLength - 1] + 1][0] = DIFF_INSERT; equalitiesLength--; // Throw away the equality we just deleted; lastequality = null; if (preIns && preDel) { // No changes made which could affect previous entry, keep going. postIns = postDel = true; equalitiesLength = 0; } else { equalitiesLength--; // Throw away the previous equality. pointer = equalitiesLength > 0 ? equalities[equalitiesLength - 1] : -1; postIns = postDel = false; } changes = true; } } pointer++; } if (changes) { this.diffCleanupMerge(diffs); } }; /** * Convert a diff array into a pretty HTML report. * @param {!Array.} diffs Array of diff tuples. * @param {integer} string to be beautified. * @return {string} HTML representation. */ DiffMatchPatch.prototype.diffPrettyHtml = function (diffs) { var op, data, x, html = []; for (x = 0; x < diffs.length; x++) { op = diffs[x][0]; // Operation (insert, delete, equal) data = diffs[x][1]; // Text of change. switch (op) { case DIFF_INSERT: html[x] = "" + escapeText(data) + ""; break; case DIFF_DELETE: html[x] = "" + escapeText(data) + ""; break; case DIFF_EQUAL: html[x] = "" + escapeText(data) + ""; break; } } return html.join(""); }; /** * Determine the common prefix of two strings. * @param {string} text1 First string. * @param {string} text2 Second string. * @return {number} The number of characters common to the start of each * string. */ DiffMatchPatch.prototype.diffCommonPrefix = function (text1, text2) { var pointermid, pointermax, pointermin, pointerstart; // Quick check for common null cases. if (!text1 || !text2 || text1.charAt(0) !== text2.charAt(0)) { return 0; } // Binary search. // Performance analysis: https://neil.fraser.name/news/2007/10/09/ pointermin = 0; pointermax = Math.min(text1.length, text2.length); pointermid = pointermax; pointerstart = 0; while (pointermin < pointermid) { if (text1.substring(pointerstart, pointermid) === text2.substring(pointerstart, pointermid)) { pointermin = pointermid; pointerstart = pointermin; } else { pointermax = pointermid; } pointermid = Math.floor((pointermax - pointermin) / 2 + pointermin); } return pointermid; }; /** * Determine the common suffix of two strings. * @param {string} text1 First string. * @param {string} text2 Second string. * @return {number} The number of characters common to the end of each string. */ DiffMatchPatch.prototype.diffCommonSuffix = function (text1, text2) { var pointermid, pointermax, pointermin, pointerend; // Quick check for common null cases. if (!text1 || !text2 || text1.charAt(text1.length - 1) !== text2.charAt(text2.length - 1)) { return 0; } // Binary search. // Performance analysis: https://neil.fraser.name/news/2007/10/09/ pointermin = 0; pointermax = Math.min(text1.length, text2.length); pointermid = pointermax; pointerend = 0; while (pointermin < pointermid) { if (text1.substring(text1.length - pointermid, text1.length - pointerend) === text2.substring(text2.length - pointermid, text2.length - pointerend)) { pointermin = pointermid; pointerend = pointermin; } else { pointermax = pointermid; } pointermid = Math.floor((pointermax - pointermin) / 2 + pointermin); } return pointermid; }; /** * Find the differences between two texts. Assumes that the texts do not * have any common prefix or suffix. * @param {string} text1 Old string to be diffed. * @param {string} text2 New string to be diffed. * @param {boolean} checklines Speedup flag. If false, then don't run a * line-level diff first to identify the changed areas. * If true, then run a faster, slightly less optimal diff. * @param {number} deadline Time when the diff should be complete by. * @return {!Array.} Array of diff tuples. * @private */ DiffMatchPatch.prototype.diffCompute = function (text1, text2, checklines, deadline) { var diffs, longtext, shorttext, i, hm, text1A, text2A, text1B, text2B, midCommon, diffsA, diffsB; if (!text1) { // Just add some text (speedup). return [[DIFF_INSERT, text2]]; } if (!text2) { // Just delete some text (speedup). return [[DIFF_DELETE, text1]]; } longtext = text1.length > text2.length ? text1 : text2; shorttext = text1.length > text2.length ? text2 : text1; i = longtext.indexOf(shorttext); if (i !== -1) { // Shorter text is inside the longer text (speedup). diffs = [[DIFF_INSERT, longtext.substring(0, i)], [DIFF_EQUAL, shorttext], [DIFF_INSERT, longtext.substring(i + shorttext.length)]]; // Swap insertions for deletions if diff is reversed. if (text1.length > text2.length) { diffs[0][0] = diffs[2][0] = DIFF_DELETE; } return diffs; } if (shorttext.length === 1) { // Single character string. // After the previous speedup, the character can't be an equality. return [[DIFF_DELETE, text1], [DIFF_INSERT, text2]]; } // Check to see if the problem can be split in two. hm = this.diffHalfMatch(text1, text2); if (hm) { // A half-match was found, sort out the return data. text1A = hm[0]; text1B = hm[1]; text2A = hm[2]; text2B = hm[3]; midCommon = hm[4]; // Send both pairs off for separate processing. diffsA = this.DiffMain(text1A, text2A, checklines, deadline); diffsB = this.DiffMain(text1B, text2B, checklines, deadline); // Merge the results. return diffsA.concat([[DIFF_EQUAL, midCommon]], diffsB); } if (checklines && text1.length > 100 && text2.length > 100) { return this.diffLineMode(text1, text2, deadline); } return this.diffBisect(text1, text2, deadline); }; /** * Do the two texts share a substring which is at least half the length of the * longer text? * This speedup can produce non-minimal diffs. * @param {string} text1 First string. * @param {string} text2 Second string. * @return {Array.} Five element Array, containing the prefix of * text1, the suffix of text1, the prefix of text2, the suffix of * text2 and the common middle. Or null if there was no match. * @private */ DiffMatchPatch.prototype.diffHalfMatch = function (text1, text2) { var longtext, shorttext, dmp, text1A, text2B, text2A, text1B, midCommon, hm1, hm2, hm; longtext = text1.length > text2.length ? text1 : text2; shorttext = text1.length > text2.length ? text2 : text1; if (longtext.length < 4 || shorttext.length * 2 < longtext.length) { return null; // Pointless. } dmp = this; // 'this' becomes 'window' in a closure. /** * Does a substring of shorttext exist within longtext such that the substring * is at least half the length of longtext? * Closure, but does not reference any external variables. * @param {string} longtext Longer string. * @param {string} shorttext Shorter string. * @param {number} i Start index of quarter length substring within longtext. * @return {Array.} Five element Array, containing the prefix of * longtext, the suffix of longtext, the prefix of shorttext, the suffix * of shorttext and the common middle. Or null if there was no match. * @private */ function diffHalfMatchI(longtext, shorttext, i) { var seed, j, bestCommon, prefixLength, suffixLength, bestLongtextA, bestLongtextB, bestShorttextA, bestShorttextB; // Start with a 1/4 length substring at position i as a seed. seed = longtext.substring(i, i + Math.floor(longtext.length / 4)); j = -1; bestCommon = ""; while ((j = shorttext.indexOf(seed, j + 1)) !== -1) { prefixLength = dmp.diffCommonPrefix(longtext.substring(i), shorttext.substring(j)); suffixLength = dmp.diffCommonSuffix(longtext.substring(0, i), shorttext.substring(0, j)); if (bestCommon.length < suffixLength + prefixLength) { bestCommon = shorttext.substring(j - suffixLength, j) + shorttext.substring(j, j + prefixLength); bestLongtextA = longtext.substring(0, i - suffixLength); bestLongtextB = longtext.substring(i + prefixLength); bestShorttextA = shorttext.substring(0, j - suffixLength); bestShorttextB = shorttext.substring(j + prefixLength); } } if (bestCommon.length * 2 >= longtext.length) { return [bestLongtextA, bestLongtextB, bestShorttextA, bestShorttextB, bestCommon]; } else { return null; } } // First check if the second quarter is the seed for a half-match. hm1 = diffHalfMatchI(longtext, shorttext, Math.ceil(longtext.length / 4)); // Check again based on the third quarter. hm2 = diffHalfMatchI(longtext, shorttext, Math.ceil(longtext.length / 2)); if (!hm1 && !hm2) { return null; } else if (!hm2) { hm = hm1; } else if (!hm1) { hm = hm2; } else { // Both matched. Select the longest. hm = hm1[4].length > hm2[4].length ? hm1 : hm2; } // A half-match was found, sort out the return data. if (text1.length > text2.length) { text1A = hm[0]; text1B = hm[1]; text2A = hm[2]; text2B = hm[3]; } else { text2A = hm[0]; text2B = hm[1]; text1A = hm[2]; text1B = hm[3]; } midCommon = hm[4]; return [text1A, text1B, text2A, text2B, midCommon]; }; /** * Do a quick line-level diff on both strings, then rediff the parts for * greater accuracy. * This speedup can produce non-minimal diffs. * @param {string} text1 Old string to be diffed. * @param {string} text2 New string to be diffed. * @param {number} deadline Time when the diff should be complete by. * @return {!Array.} Array of diff tuples. * @private */ DiffMatchPatch.prototype.diffLineMode = function (text1, text2, deadline) { var a, diffs, linearray, pointer, countInsert, countDelete, textInsert, textDelete, j; // Scan the text on a line-by-line basis first. a = this.diffLinesToChars(text1, text2); text1 = a.chars1; text2 = a.chars2; linearray = a.lineArray; diffs = this.DiffMain(text1, text2, false, deadline); // Convert the diff back to original text. this.diffCharsToLines(diffs, linearray); // Eliminate freak matches (e.g. blank lines) this.diffCleanupSemantic(diffs); // Rediff any replacement blocks, this time character-by-character. // Add a dummy entry at the end. diffs.push([DIFF_EQUAL, ""]); pointer = 0; countDelete = 0; countInsert = 0; textDelete = ""; textInsert = ""; while (pointer < diffs.length) { switch (diffs[pointer][0]) { case DIFF_INSERT: countInsert++; textInsert += diffs[pointer][1]; break; case DIFF_DELETE: countDelete++; textDelete += diffs[pointer][1]; break; case DIFF_EQUAL: // Upon reaching an equality, check for prior redundancies. if (countDelete >= 1 && countInsert >= 1) { // Delete the offending records and add the merged ones. diffs.splice(pointer - countDelete - countInsert, countDelete + countInsert); pointer = pointer - countDelete - countInsert; a = this.DiffMain(textDelete, textInsert, false, deadline); for (j = a.length - 1; j >= 0; j--) { diffs.splice(pointer, 0, a[j]); } pointer = pointer + a.length; } countInsert = 0; countDelete = 0; textDelete = ""; textInsert = ""; break; } pointer++; } diffs.pop(); // Remove the dummy entry at the end. return diffs; }; /** * Find the 'middle snake' of a diff, split the problem in two * and return the recursively constructed diff. * See Myers 1986 paper: An O(ND) Difference Algorithm and Its Variations. * @param {string} text1 Old string to be diffed. * @param {string} text2 New string to be diffed. * @param {number} deadline Time at which to bail if not yet complete. * @return {!Array.} Array of diff tuples. * @private */ DiffMatchPatch.prototype.diffBisect = function (text1, text2, deadline) { var text1Length, text2Length, maxD, vOffset, vLength, v1, v2, x, delta, front, k1start, k1end, k2start, k2end, k2Offset, k1Offset, x1, x2, y1, y2, d, k1, k2; // Cache the text lengths to prevent multiple calls. text1Length = text1.length; text2Length = text2.length; maxD = Math.ceil((text1Length + text2Length) / 2); vOffset = maxD; vLength = 2 * maxD; v1 = new Array(vLength); v2 = new Array(vLength); // Setting all elements to -1 is faster in Chrome & Firefox than mixing // integers and undefined. for (x = 0; x < vLength; x++) { v1[x] = -1; v2[x] = -1; } v1[vOffset + 1] = 0; v2[vOffset + 1] = 0; delta = text1Length - text2Length; // If the total number of characters is odd, then the front path will collide // with the reverse path. front = delta % 2 !== 0; // Offsets for start and end of k loop. // Prevents mapping of space beyond the grid. k1start = 0; k1end = 0; k2start = 0; k2end = 0; for (d = 0; d < maxD; d++) { // Bail out if deadline is reached. if (new Date().getTime() > deadline) { break; } // Walk the front path one step. for (k1 = -d + k1start; k1 <= d - k1end; k1 += 2) { k1Offset = vOffset + k1; if (k1 === -d || k1 !== d && v1[k1Offset - 1] < v1[k1Offset + 1]) { x1 = v1[k1Offset + 1]; } else { x1 = v1[k1Offset - 1] + 1; } y1 = x1 - k1; while (x1 < text1Length && y1 < text2Length && text1.charAt(x1) === text2.charAt(y1)) { x1++; y1++; } v1[k1Offset] = x1; if (x1 > text1Length) { // Ran off the right of the graph. k1end += 2; } else if (y1 > text2Length) { // Ran off the bottom of the graph. k1start += 2; } else if (front) { k2Offset = vOffset + delta - k1; if (k2Offset >= 0 && k2Offset < vLength && v2[k2Offset] !== -1) { // Mirror x2 onto top-left coordinate system. x2 = text1Length - v2[k2Offset]; if (x1 >= x2) { // Overlap detected. return this.diffBisectSplit(text1, text2, x1, y1, deadline); } } } } // Walk the reverse path one step. for (k2 = -d + k2start; k2 <= d - k2end; k2 += 2) { k2Offset = vOffset + k2; if (k2 === -d || k2 !== d && v2[k2Offset - 1] < v2[k2Offset + 1]) { x2 = v2[k2Offset + 1]; } else { x2 = v2[k2Offset - 1] + 1; } y2 = x2 - k2; while (x2 < text1Length && y2 < text2Length && text1.charAt(text1Length - x2 - 1) === text2.charAt(text2Length - y2 - 1)) { x2++; y2++; } v2[k2Offset] = x2; if (x2 > text1Length) { // Ran off the left of the graph. k2end += 2; } else if (y2 > text2Length) { // Ran off the top of the graph. k2start += 2; } else if (!front) { k1Offset = vOffset + delta - k2; if (k1Offset >= 0 && k1Offset < vLength && v1[k1Offset] !== -1) { x1 = v1[k1Offset]; y1 = vOffset + x1 - k1Offset; // Mirror x2 onto top-left coordinate system. x2 = text1Length - x2; if (x1 >= x2) { // Overlap detected. return this.diffBisectSplit(text1, text2, x1, y1, deadline); } } } } } // Diff took too long and hit the deadline or // number of diffs equals number of characters, no commonality at all. return [[DIFF_DELETE, text1], [DIFF_INSERT, text2]]; }; /** * Given the location of the 'middle snake', split the diff in two parts * and recurse. * @param {string} text1 Old string to be diffed. * @param {string} text2 New string to be diffed. * @param {number} x Index of split point in text1. * @param {number} y Index of split point in text2. * @param {number} deadline Time at which to bail if not yet complete. * @return {!Array.} Array of diff tuples. * @private */ DiffMatchPatch.prototype.diffBisectSplit = function (text1, text2, x, y, deadline) { var text1a, text1b, text2a, text2b, diffs, diffsb; text1a = text1.substring(0, x); text2a = text2.substring(0, y); text1b = text1.substring(x); text2b = text2.substring(y); // Compute both diffs serially. diffs = this.DiffMain(text1a, text2a, false, deadline); diffsb = this.DiffMain(text1b, text2b, false, deadline); return diffs.concat(diffsb); }; /** * Reduce the number of edits by eliminating semantically trivial equalities. * @param {!Array.} diffs Array of diff tuples. */ DiffMatchPatch.prototype.diffCleanupSemantic = function (diffs) { var changes, equalities, equalitiesLength, lastequality, pointer, lengthInsertions2, lengthDeletions2, lengthInsertions1, lengthDeletions1, deletion, insertion, overlapLength1, overlapLength2; changes = false; equalities = []; // Stack of indices where equalities are found. equalitiesLength = 0; // Keeping our own length var is faster in JS. /** @type {?string} */ lastequality = null; // Always equal to diffs[equalities[equalitiesLength - 1]][1] pointer = 0; // Index of current position. // Number of characters that changed prior to the equality. lengthInsertions1 = 0; lengthDeletions1 = 0; // Number of characters that changed after the equality. lengthInsertions2 = 0; lengthDeletions2 = 0; while (pointer < diffs.length) { if (diffs[pointer][0] === DIFF_EQUAL) { // Equality found. equalities[equalitiesLength++] = pointer; lengthInsertions1 = lengthInsertions2; lengthDeletions1 = lengthDeletions2; lengthInsertions2 = 0; lengthDeletions2 = 0; lastequality = diffs[pointer][1]; } else { // An insertion or deletion. if (diffs[pointer][0] === DIFF_INSERT) { lengthInsertions2 += diffs[pointer][1].length; } else { lengthDeletions2 += diffs[pointer][1].length; } // Eliminate an equality that is smaller or equal to the edits on both // sides of it. if (lastequality && lastequality.length <= Math.max(lengthInsertions1, lengthDeletions1) && lastequality.length <= Math.max(lengthInsertions2, lengthDeletions2)) { // Duplicate record. diffs.splice(equalities[equalitiesLength - 1], 0, [DIFF_DELETE, lastequality]); // Change second copy to insert. diffs[equalities[equalitiesLength - 1] + 1][0] = DIFF_INSERT; // Throw away the equality we just deleted. equalitiesLength--; // Throw away the previous equality (it needs to be reevaluated). equalitiesLength--; pointer = equalitiesLength > 0 ? equalities[equalitiesLength - 1] : -1; // Reset the counters. lengthInsertions1 = 0; lengthDeletions1 = 0; lengthInsertions2 = 0; lengthDeletions2 = 0; lastequality = null; changes = true; } } pointer++; } // Normalize the diff. if (changes) { this.diffCleanupMerge(diffs); } // Find any overlaps between deletions and insertions. // e.g: abcxxxxxxdef // -> abcxxxdef // e.g: xxxabcdefxxx // -> defxxxabc // Only extract an overlap if it is as big as the edit ahead or behind it. pointer = 1; while (pointer < diffs.length) { if (diffs[pointer - 1][0] === DIFF_DELETE && diffs[pointer][0] === DIFF_INSERT) { deletion = diffs[pointer - 1][1]; insertion = diffs[pointer][1]; overlapLength1 = this.diffCommonOverlap(deletion, insertion); overlapLength2 = this.diffCommonOverlap(insertion, deletion); if (overlapLength1 >= overlapLength2) { if (overlapLength1 >= deletion.length / 2 || overlapLength1 >= insertion.length / 2) { // Overlap found. Insert an equality and trim the surrounding edits. diffs.splice(pointer, 0, [DIFF_EQUAL, insertion.substring(0, overlapLength1)]); diffs[pointer - 1][1] = deletion.substring(0, deletion.length - overlapLength1); diffs[pointer + 1][1] = insertion.substring(overlapLength1); pointer++; } } else { if (overlapLength2 >= deletion.length / 2 || overlapLength2 >= insertion.length / 2) { // Reverse overlap found. // Insert an equality and swap and trim the surrounding edits. diffs.splice(pointer, 0, [DIFF_EQUAL, deletion.substring(0, overlapLength2)]); diffs[pointer - 1][0] = DIFF_INSERT; diffs[pointer - 1][1] = insertion.substring(0, insertion.length - overlapLength2); diffs[pointer + 1][0] = DIFF_DELETE; diffs[pointer + 1][1] = deletion.substring(overlapLength2); pointer++; } } pointer++; } pointer++; } }; /** * Determine if the suffix of one string is the prefix of another. * @param {string} text1 First string. * @param {string} text2 Second string. * @return {number} The number of characters common to the end of the first * string and the start of the second string. * @private */ DiffMatchPatch.prototype.diffCommonOverlap = function (text1, text2) { var text1Length, text2Length, textLength, best, length, pattern, found; // Cache the text lengths to prevent multiple calls. text1Length = text1.length; text2Length = text2.length; // Eliminate the null case. if (text1Length === 0 || text2Length === 0) { return 0; } // Truncate the longer string. if (text1Length > text2Length) { text1 = text1.substring(text1Length - text2Length); } else if (text1Length < text2Length) { text2 = text2.substring(0, text1Length); } textLength = Math.min(text1Length, text2Length); // Quick check for the worst case. if (text1 === text2) { return textLength; } // Start by looking for a single character match // and increase length until no match is found. // Performance analysis: https://neil.fraser.name/news/2010/11/04/ best = 0; length = 1; while (true) { pattern = text1.substring(textLength - length); found = text2.indexOf(pattern); if (found === -1) { return best; } length += found; if (found === 0 || text1.substring(textLength - length) === text2.substring(0, length)) { best = length; length++; } } }; /** * Split two texts into an array of strings. Reduce the texts to a string of * hashes where each Unicode character represents one line. * @param {string} text1 First string. * @param {string} text2 Second string. * @return {{chars1: string, chars2: string, lineArray: !Array.}} * An object containing the encoded text1, the encoded text2 and * the array of unique strings. * The zeroth element of the array of unique strings is intentionally blank. * @private */ DiffMatchPatch.prototype.diffLinesToChars = function (text1, text2) { var lineArray, lineHash, chars1, chars2; lineArray = []; // E.g. lineArray[4] === 'Hello\n' lineHash = {}; // E.g. lineHash['Hello\n'] === 4 // '\x00' is a valid character, but various debuggers don't like it. // So we'll insert a junk entry to avoid generating a null character. lineArray[0] = ""; /** * Split a text into an array of strings. Reduce the texts to a string of * hashes where each Unicode character represents one line. * Modifies linearray and linehash through being a closure. * @param {string} text String to encode. * @return {string} Encoded string. * @private */ function diffLinesToCharsMunge(text) { var chars, lineStart, lineEnd, lineArrayLength, line; chars = ""; // Walk the text, pulling out a substring for each line. // text.split('\n') would would temporarily double our memory footprint. // Modifying text would create many large strings to garbage collect. lineStart = 0; lineEnd = -1; // Keeping our own length variable is faster than looking it up. lineArrayLength = lineArray.length; while (lineEnd < text.length - 1) { lineEnd = text.indexOf("\n", lineStart); if (lineEnd === -1) { lineEnd = text.length - 1; } line = text.substring(lineStart, lineEnd + 1); lineStart = lineEnd + 1; var lineHashExists = lineHash.hasOwnProperty ? lineHash.hasOwnProperty(line) : lineHash[line] !== undefined; if (lineHashExists) { chars += String.fromCharCode(lineHash[line]); } else { chars += String.fromCharCode(lineArrayLength); lineHash[line] = lineArrayLength; lineArray[lineArrayLength++] = line; } } return chars; } chars1 = diffLinesToCharsMunge(text1); chars2 = diffLinesToCharsMunge(text2); return { chars1: chars1, chars2: chars2, lineArray: lineArray }; }; /** * Rehydrate the text in a diff from a string of line hashes to real lines of * text. * @param {!Array.} diffs Array of diff tuples. * @param {!Array.} lineArray Array of unique strings. * @private */ DiffMatchPatch.prototype.diffCharsToLines = function (diffs, lineArray) { var x, chars, text, y; for (x = 0; x < diffs.length; x++) { chars = diffs[x][1]; text = []; for (y = 0; y < chars.length; y++) { text[y] = lineArray[chars.charCodeAt(y)]; } diffs[x][1] = text.join(""); } }; /** * Reorder and merge like edit sections. Merge equalities. * Any edit section can move as long as it doesn't cross an equality. * @param {!Array.} diffs Array of diff tuples. */ DiffMatchPatch.prototype.diffCleanupMerge = function (diffs) { var pointer, countDelete, countInsert, textInsert, textDelete, commonlength, changes, diffPointer, position; diffs.push([DIFF_EQUAL, ""]); // Add a dummy entry at the end. pointer = 0; countDelete = 0; countInsert = 0; textDelete = ""; textInsert = ""; while (pointer < diffs.length) { switch (diffs[pointer][0]) { case DIFF_INSERT: countInsert++; textInsert += diffs[pointer][1]; pointer++; break; case DIFF_DELETE: countDelete++; textDelete += diffs[pointer][1]; pointer++; break; case DIFF_EQUAL: // Upon reaching an equality, check for prior redundancies. if (countDelete + countInsert > 1) { if (countDelete !== 0 && countInsert !== 0) { // Factor out any common prefixes. commonlength = this.diffCommonPrefix(textInsert, textDelete); if (commonlength !== 0) { if (pointer - countDelete - countInsert > 0 && diffs[pointer - countDelete - countInsert - 1][0] === DIFF_EQUAL) { diffs[pointer - countDelete - countInsert - 1][1] += textInsert.substring(0, commonlength); } else { diffs.splice(0, 0, [DIFF_EQUAL, textInsert.substring(0, commonlength)]); pointer++; } textInsert = textInsert.substring(commonlength); textDelete = textDelete.substring(commonlength); } // Factor out any common suffixies. commonlength = this.diffCommonSuffix(textInsert, textDelete); if (commonlength !== 0) { diffs[pointer][1] = textInsert.substring(textInsert.length - commonlength) + diffs[pointer][1]; textInsert = textInsert.substring(0, textInsert.length - commonlength); textDelete = textDelete.substring(0, textDelete.length - commonlength); } } // Delete the offending records and add the merged ones. if (countDelete === 0) { diffs.splice(pointer - countInsert, countDelete + countInsert, [DIFF_INSERT, textInsert]); } else if (countInsert === 0) { diffs.splice(pointer - countDelete, countDelete + countInsert, [DIFF_DELETE, textDelete]); } else { diffs.splice(pointer - countDelete - countInsert, countDelete + countInsert, [DIFF_DELETE, textDelete], [DIFF_INSERT, textInsert]); } pointer = pointer - countDelete - countInsert + (countDelete ? 1 : 0) + (countInsert ? 1 : 0) + 1; } else if (pointer !== 0 && diffs[pointer - 1][0] === DIFF_EQUAL) { // Merge this equality with the previous one. diffs[pointer - 1][1] += diffs[pointer][1]; diffs.splice(pointer, 1); } else { pointer++; } countInsert = 0; countDelete = 0; textDelete = ""; textInsert = ""; break; } } if (diffs[diffs.length - 1][1] === "") { diffs.pop(); // Remove the dummy entry at the end. } // Second pass: look for single edits surrounded on both sides by equalities // which can be shifted sideways to eliminate an equality. // e.g: ABAC -> ABAC changes = false; pointer = 1; // Intentionally ignore the first and last element (don't need checking). while (pointer < diffs.length - 1) { if (diffs[pointer - 1][0] === DIFF_EQUAL && diffs[pointer + 1][0] === DIFF_EQUAL) { diffPointer = diffs[pointer][1]; position = diffPointer.substring(diffPointer.length - diffs[pointer - 1][1].length); // This is a single edit surrounded by equalities. if (position === diffs[pointer - 1][1]) { // Shift the edit over the previous equality. diffs[pointer][1] = diffs[pointer - 1][1] + diffs[pointer][1].substring(0, diffs[pointer][1].length - diffs[pointer - 1][1].length); diffs[pointer + 1][1] = diffs[pointer - 1][1] + diffs[pointer + 1][1]; diffs.splice(pointer - 1, 1); changes = true; } else if (diffPointer.substring(0, diffs[pointer + 1][1].length) === diffs[pointer + 1][1]) { // Shift the edit over the next equality. diffs[pointer - 1][1] += diffs[pointer + 1][1]; diffs[pointer][1] = diffs[pointer][1].substring(diffs[pointer + 1][1].length) + diffs[pointer + 1][1]; diffs.splice(pointer + 1, 1); changes = true; } } pointer++; } // If shifts were made, the diff needs reordering and another shift sweep. if (changes) { this.diffCleanupMerge(diffs); } }; return function (o, n) { var diff, output, text; diff = new DiffMatchPatch(); output = diff.DiffMain(o, n); diff.diffCleanupEfficiency(output); text = diff.diffPrettyHtml(output); return text; }; }(); }((function() { return this; }()))); ================================================ FILE: tests.html ================================================ Unit tests for LInQer
      ================================================ FILE: tests.js ================================================ /* eslint-disable no-undef */ Enumerable = Linqer.Enumerable; // object and method tests QUnit.module('object and method tests'); QUnit.test( "Enumerable.from with empty array", function( assert ) { const enumerable = Enumerable.from([]); const result =[]; for (const item of enumerable) result.push(item); assert.deepEqual( result,[], "Passed!" ); }); QUnit.test( "Enumerable.from with non empty array", function( assert ) { const enumerable = Enumerable.from([1,'a2',3,null]); const result =[]; for (const item of enumerable) result.push(item); assert.deepEqual( result,[1,'a2',3,null], "Passed!" ); }); QUnit.test( "Enumerable.from with generator function", function( assert ) { function* gen() { yield 1; yield 'a2'; yield 3; yield null; } const enumerable = Enumerable.from(gen()); const result =[]; for (const item of enumerable) result.push(item); assert.deepEqual( result,[1,'a2',3,null], "Passed!" ); }); QUnit.test( "Enumerable.empty", function( assert ) { const enumerable = Enumerable.empty(); const result =[]; for (const item of enumerable) result.push(item); assert.deepEqual( result,[], "Passed!" ); }); QUnit.test( "Enumerable.range", function( assert ) { const enumerable = Enumerable.range(10,2); const result =[]; for (const item of enumerable) result.push(item); assert.deepEqual( result,[10,11], "Passed!" ); }); QUnit.test( "Enumerable.repeat", function( assert ) { const enumerable = Enumerable.repeat(10,2); const result =[]; for (const item of enumerable) result.push(item); assert.deepEqual( result,[10,10], "Passed!" ); }); QUnit.test( "Enumerable.aggregate with numbers", function( assert ) { const result = Enumerable.from([1,2,3]).aggregate(10,(acc,item)=>acc+item*2); assert.deepEqual( result,22, "Passed!" ); }); QUnit.test( "Enumerable.aggregate with text", function( assert ) { const result = Enumerable.from([1,2,3]).aggregate(10,(acc,item)=>acc+' '+(item*2)); assert.deepEqual( result,'10 2 4 6', "Passed!" ); }); QUnit.test( "Enumerable.all true", function( assert ) { const result = Enumerable.from([1,2,3]).all(item=>item>0); assert.deepEqual( result,true, "Passed!" ); }); QUnit.test( "Enumerable.all false", function( assert ) { const result = Enumerable.from([1,2,3]).all(item=>item>2); assert.deepEqual( result,false, "Passed!" ); }); QUnit.test( "Enumerable.any true", function( assert ) { const result = Enumerable.from([1,2,3]).any(item=>item>2); assert.deepEqual( result,true, "Passed!" ); }); QUnit.test( "Enumerable.any false", function( assert ) { const result = Enumerable.from([1,2,3]).any(item=>item>10); assert.deepEqual( result,false, "Passed!" ); }); QUnit.test( "Enumerable.append", function( assert ) { const result = Enumerable.from([1,2,3]).append(4).toArray(); assert.deepEqual( result,[1,2,3,4], "Passed!" ); }); QUnit.test( "Enumerable.average empty", function( assert ) { const result = Enumerable.from([]).average(); assert.deepEqual( result,undefined, "Passed!" ); }); QUnit.test( "Enumerable.average numbers", function( assert ) { const result = Enumerable.from([1,2,3]).average(); assert.deepEqual( result,2, "Passed!" ); }); QUnit.test( "Enumerable.average not numbers", function( assert ) { const result = Enumerable.from([1,'xx2',5]).average(); assert.deepEqual( result,Number.NaN, "Passed!" ); }); QUnit.test( "Enumerable.concat", function( assert ) { const result = Enumerable.from([1,'xx2',5]).concat([6,7,8]).toArray(); assert.deepEqual( result,[1,'xx2',5,6,7,8], "Passed!" ); }); QUnit.test( "Enumerable.contains true", function( assert ) { const result = Enumerable.from([1,'xx2',5]).contains(5); assert.deepEqual( result,true, "Passed!" ); }); QUnit.test( "Enumerable.contains false", function( assert ) { const result = Enumerable.from([1,'xx2',5]).contains(6); assert.deepEqual( result,false, "Passed!" ); }); QUnit.test( "Enumerable.count array", function( assert ) { const result = Enumerable.from([1,'xx2',5]).count(); assert.deepEqual( result,3, "Passed!" ); }); QUnit.test( "Enumerable.count Map", function( assert ) { const map = new Map(); map.set(1,2); map.set('a','3'); const result = Enumerable.from(map).count(); assert.deepEqual( result,2, "Passed!" ); }); QUnit.test( "Enumerable.count Set", function( assert ) { const result = Enumerable.from(new Set().add(1).add(2).add(3).add(4)).count(); assert.deepEqual( result,4, "Passed!" ); }); QUnit.test( "Enumerable.count generator function", function( assert ) { function* gen() { yield 'a'; yield 1; } const result = Enumerable.from(gen()).count(); assert.deepEqual( result,2, "Passed!" ); }); QUnit.test( "Enumerable.distinct", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).distinct().toArray(); assert.deepEqual( result,[1,2,3,'3'], "Passed!" ); }); QUnit.test( "Enumerable.distinct equality comparer", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).distinct((i1,i2)=>+(i1) === +(i2)).toArray(); assert.deepEqual( result,[1,2,3], "Passed!" ); }); QUnit.test( "Enumerable.elementAt in range array", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).elementAt(3); assert.deepEqual( result,3, "Passed!" ); }); QUnit.test( "Enumerable.elementAt below range array", function( assert ) { assert.throws( ()=>Enumerable.from([1,2,2,3,'3']).elementAt(-3), "Passed!" ); }); QUnit.test( "Enumerable.elementAt above range array", function( assert ) { assert.throws( ()=>Enumerable.from([1,2,2,3,'3']).elementAt(30), "Passed!" ); }); QUnit.test( "Enumerable.elementAtOrDefault in range array", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).elementAtOrDefault(3); assert.deepEqual( result,3, "Passed!" ); }); QUnit.test( "Enumerable.elementAtOrDefault below range array", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).elementAtOrDefault(-3); assert.deepEqual( result,undefined, "Passed!" ); }); QUnit.test( "Enumerable.elementAtOrDefault above range array", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).elementAtOrDefault(30); assert.deepEqual( result,undefined, "Passed!" ); }); QUnit.test( "Enumerable.except", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).except([2,3]).toArray(); assert.deepEqual( result,[1,'3'], "Passed!" ); }); QUnit.test( "Enumerable.except equality comparer", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).except([2,3],(i1,i2)=>+(i1) === +(i2)).toArray(); assert.deepEqual( result,[1], "Passed!" ); }); QUnit.test( "Enumerable.first", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).first(); assert.deepEqual( result,1, "Passed!" ); }); QUnit.test( "Enumerable.first empty", function( assert ) { assert.throws(()=>Enumerable.from([]).first(), "Passed!" ); }); QUnit.test( "Enumerable.firstOrDefault", function( assert ) { const result = Enumerable.from([]).firstOrDefault(); assert.deepEqual( result,undefined, "Passed!" ); }); QUnit.test( "Enumerable.groupBy", function( assert ) { const result = Enumerable.from([1,2,2,3,'3','sasa','0x4']).groupBy(item=>+(item)>2).toArray(); assert.deepEqual( result.length,2, "Passed!" ); assert.deepEqual( result[0].key,false, "Passed!" ); assert.deepEqual( result[0].toArray(),[1,2,2,'sasa'], "Passed!" ); assert.deepEqual( result[1].key,true, "Passed!" ); assert.deepEqual( result[1].toArray(),[3,'3','0x4'], "Passed!" ); }); QUnit.test( "Enumerable.groupJoin", function( assert ) { const result = Enumerable.from([1,2,3,4,37]) .groupJoin([10,12,331,13,56,3,22,57,43,467,212],i=>i+'',i=>(i+'').charAt(0),(i1,i2)=>{ return {i1:i1,i2:i2}; }) .toArray(); assert.deepEqual(result, [ { 'i1': 1, 'i2': [10, 12, 13] }, { 'i1': 2, 'i2': [22, 212] }, { 'i1': 3, 'i2': [331, 3] }, { 'i1': 4, 'i2': [43, 467] }, { 'i1': 37, 'i2': [] } ], "Passed!"); }); QUnit.test( "Enumerable.groupJoin equality comparer", function( assert ) { const result = Enumerable.from([1,2,3,4,37]) .groupJoin([10,12,331,13,56,3,22,57,43,467,212],i=>i,i=>i,(i1,i2)=>{ return {i1:i1,i2:i2}; },(i1,i2)=>i2%i1===0) .toArray(); assert.deepEqual(result, [ { 'i1': 1, 'i2': [10, 12, 331, 13, 56, 3, 22, 57, 43, 467, 212] }, { 'i1': 2, 'i2': [10, 12, 56, 22, 212] }, { 'i1': 3, 'i2': [12, 3, 57] }, { 'i1': 4, 'i2': [12, 56, 212] }, { 'i1': 37, 'i2': [] } ], "Passed!"); }); QUnit.test( "Enumerable.intersect", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).intersect([2,3,4]).toArray(); assert.deepEqual( result,[2,2,3], "Passed!" ); }); QUnit.test( "Enumerable.intersect equality comparer", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).intersect([2,3,4],(i1,i2)=>+i1 === +i2).toArray(); assert.deepEqual( result,[2,2,3,'3'], "Passed!" ); }); QUnit.test( "Enumerable.join", function( assert ) { const result = Enumerable.from([1,2,3,4,37]) .join([10,12,331,13,56,3,22,57,43,467,212],i=>i+'',i=>(i+'').charAt(0),(i1,i2)=>i1+':'+i2) .toArray(); assert.deepEqual(result, [ '1:10', '1:12', '1:13', '2:22', '2:212', '3:331', '3:3', '4:43', '4:467' ], "Passed!"); }); QUnit.test( "Enumerable.join equality comparer", function( assert ) { const result = Enumerable.from([1,2,3,4,37]) .join([10,12,331,13,56,3,22,57,43,467,212],i=>i,i=>i,(i1,i2)=>i1+':'+i2,(i1,i2)=>i2%i1===0) .toArray(); assert.deepEqual(result, [ '1:10', '1:12', '1:331', '1:13', '1:56', '1:3', '1:22', '1:57', '1:43', '1:467', '1:212', '2:10', '2:12', '2:56', '2:22', '2:212', '3:12', '3:3', '3:57', '4:12', '4:56', '4:212' ], "Passed!"); }); QUnit.test( "Enumerable.last", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).last(); assert.deepEqual( result,'3', "Passed!" ); }); QUnit.test( "Enumerable.last empty", function( assert ) { assert.throws(()=>Enumerable.from([]).last(), "Passed!" ); }); QUnit.test( "Enumerable.lastOrDefault", function( assert ) { const result = Enumerable.from([]).lastOrDefault(); assert.deepEqual( result,undefined, "Passed!" ); }); QUnit.test( "Enumerable.longCount empty", function( assert ) { const result = Enumerable.from([]).longCount(); assert.deepEqual( result,0, "Passed!" ); }); QUnit.test( "Enumerable.longCount array", function( assert ) { const result = Enumerable.from([1,2,3]).longCount(); assert.deepEqual( result,3, "Passed!" ); }); QUnit.test( "Enumerable.max numbers", function( assert ) { const result = Enumerable.from([3,5,1,2,56,2,-100,43]).max(); assert.deepEqual( result,56, "Passed!" ); }); QUnit.test( "Enumerable.max strings", function( assert ) { const result = Enumerable.from(['ba','a','abba','aaa','bb']).max(); assert.deepEqual( result,'bb', "Passed!" ); }); QUnit.test( "Enumerable.min number", function( assert ) { const result = Enumerable.from([3,5,1,2,56,2,-100,43]).min(); assert.deepEqual( result,-100, "Passed!" ); }); QUnit.test( "Enumerable.min custom comparer", function( assert ) { const result = Enumerable.from([3,5,1,2,56,2,-100,43]).min((i1,i2)=>i1.toString().length-i2.toString().length); assert.deepEqual( result,3, "Passed!" ); }); QUnit.test( "Enumerable.ofType string parameter", function( assert ) { const result = Enumerable.from([undefined, null, Number.NaN,1,-1000,'some text',{value:'an object'}, Enumerable.empty]).ofType('string').toArray(); assert.deepEqual( result,['some text'], "Passed!" ); }); QUnit.test( "Enumerable.ofType type parameter", function( assert ) { const enumerable = Enumerable.empty(); const result = Enumerable.from([undefined, null, Number.NaN,1,-1000,'some text',{value:'an object'}, enumerable]).ofType(Linqer.Enumerable).toArray(); assert.deepEqual( result,[enumerable], "Passed!" ); }); QUnit.test( "Enumerable.orderBy", function( assert ) { const result = Enumerable.from([1,3,2,4,5,0]).orderBy().toArray(); assert.deepEqual( result,[0,1,2,3,4,5], "Passed!" ); }); QUnit.test( "Enumerable.orderBy custom comparer forced QuickSort", function( assert ) { const result = Enumerable.from([1,3,2,4,5,0]) .orderBy(i=>i%2) .take(Number.MAX_SAFE_INTEGER) // force QuickSort .toArray(); assert.deepEqual( result.map(i=>i%2),[0,0,0,1,1,1], "Passed!" ); }); QUnit.test( "Enumerable.orderBy custom comparer browser sort", function( assert ) { const result = Enumerable.from([1,3,2,4,5,0]) .useBrowserSort() .orderBy(i=>i%2) .toArray(); assert.deepEqual( result,[2,4,0,1,3,5], "Passed!" ); }); QUnit.test( "Enumerable.orderByDescending", function( assert ) { const result = Enumerable.from([1,3,2,4,5,0]).orderByDescending().toArray(); assert.deepEqual( result,[5,4,3,2,1,0], "Passed!" ); }); QUnit.test( "Enumerable.prepend", function( assert ) { const result = Enumerable.from([1,3,2]).prepend(0).toArray(); assert.deepEqual( result,[0,1,3,2], "Passed!" ); }); QUnit.test( "Enumerable.reverse", function( assert ) { const result = Enumerable.from(['a',1,3,2]).reverse().toArray(); assert.deepEqual( result,[2,3,1,'a'], "Passed!" ); }); QUnit.test( "Enumerable.select", function( assert ) { const result = Enumerable.from(['a',1,3,2]).select(item=>Number.isInteger(item)?item*item:item+'^2').toArray(); assert.deepEqual( result,['a^2',1,9,4], "Passed!" ); }); QUnit.test( "Enumerable.selectMany", function( assert ) { const result = Enumerable.from([[1,2],[2,3]]).selectMany().toArray(); assert.deepEqual( result,[1,2,2,3], "Passed!" ); }); QUnit.test( "Enumerable.selectMany custom function", function( assert ) { const result = Enumerable.from([[1,2],[2,3,4]]).selectMany(item=>[item.length]).toArray(); assert.deepEqual( result,[2,3], "Passed!" ); }); QUnit.test( "Enumerable.sequenceEqual true", function( assert ) { const result = Enumerable.from([1,2,3]).sequenceEqual([1,2,3]); assert.deepEqual( result,true, "Passed!" ); }); QUnit.test( "Enumerable.sequenceEqual false shorter", function( assert ) { const result = Enumerable.from([1,2]).sequenceEqual([1,2,3]); assert.deepEqual( result,false, "Passed!" ); }); QUnit.test( "Enumerable.sequenceEqual false shorter 2", function( assert ) { const result = Enumerable.from([1,2,3]).sequenceEqual([1,2]); assert.deepEqual( result,false, "Passed!" ); }); QUnit.test( "Enumerable.sequenceEqual false out of order", function( assert ) { const result = Enumerable.from([1,3,2]).sequenceEqual([1,2,3]); assert.deepEqual( result,false, "Passed!" ); }); QUnit.test( "Enumerable.single true", function( assert ) { const result = Enumerable.from([11]).single(); assert.deepEqual( result,11, "Passed!" ); }); QUnit.test( "Enumerable.single empty throws", function( assert ) { assert.throws( ()=>Enumerable.empty().single(), "Passed!" ); }); QUnit.test( "Enumerable.single multiple throws", function( assert ) { assert.throws( ()=>Enumerable.from([1,2]).single(), "Passed!" ); }); QUnit.test( "Enumerable.singleOrDefault true", function( assert ) { const result = Enumerable.from([11]).singleOrDefault(); assert.deepEqual( result,11, "Passed!" ); }); QUnit.test( "Enumerable.singleOrDefault empty", function( assert ) { const result = Enumerable.from([]).singleOrDefault(); assert.deepEqual( result,undefined, "Passed!" ); }); QUnit.test( "Enumerable.singleOrDefault multiple throws", function( assert ) { assert.throws( ()=>Enumerable.from([1,2]).singleOrDefault(), "Passed!" ); }); QUnit.test( "Enumerable.skip", function( assert ) { const result = Enumerable.from([1,2,3,4,5]).skip(2).toArray(); assert.deepEqual( result,[3,4,5], "Passed!" ); }); QUnit.test( "Enumerable.skipLast", function( assert ) { const result = Enumerable.from([1,2,3,4,5]).skipLast(2).toArray(); assert.deepEqual( result,[1,2,3], "Passed!" ); }); QUnit.test( "Enumerable.skipWhile", function( assert ) { const result = Enumerable.from([1,2,3,2,1]).skipWhile(item=>item<3).toArray(); assert.deepEqual( result,[3,2,1], "Passed!" ); }); QUnit.test( "Enumerable.slice empty", function( assert ) { const arr=[1,2,3,4,5]; const result = Enumerable.from(arr).slice().toArray(); assert.deepEqual( result,arr.slice(), "Passed!" ); }); QUnit.test( "Enumerable.slice positive", function( assert ) { const arr=[1,2,3,4,5]; const result = Enumerable.from(arr).slice(2).toArray(); assert.deepEqual( result,arr.slice(2), "Passed!" ); }); QUnit.test( "Enumerable.slice positive positive", function( assert ) { const arr=[1,2,3,4,5]; const result = Enumerable.from(arr).slice(2,4).toArray(); assert.deepEqual( result,arr.slice(2,4), "Passed!" ); }); QUnit.test( "Enumerable.slice negative", function( assert ) { const arr=[1,2,3,4,5]; const result = Enumerable.from(arr).slice(-2).toArray(); assert.deepEqual( result,arr.slice(-2), "Passed!" ); }); QUnit.test( "Enumerable.slice negative positive", function( assert ) { const arr=[1,2,3,4,5]; const result = Enumerable.from(arr).slice(-2,4).toArray(); assert.deepEqual( result,arr.slice(-2,4), "Passed!" ); }); QUnit.test( "Enumerable.slice negative positive 2", function( assert ) { const arr=[1,2,3,4,5]; const result = Enumerable.from(arr).slice(-4,2).toArray(); assert.deepEqual( result,arr.slice(-4,2), "Passed!" ); }); QUnit.test( "Enumerable.slice negative negative", function( assert ) { const arr=[1,2,3,4,5]; const result = Enumerable.from(arr).slice(-4,-1).toArray(); assert.deepEqual( result,arr.slice(-4,-1), "Passed!" ); }); QUnit.test( "Enumerable.sum numbers", function( assert ) { const result = Enumerable.from([1,2,3,4,5]).sum(); assert.deepEqual( result,15, "Passed!" ); }); QUnit.test( "Enumerable.sum numbers with some strings", function( assert ) { const result = Enumerable.from([1,2,3,4,5,'6']).sum(); assert.deepEqual( result,Number.NaN, "Passed!" ); }); QUnit.test( "Enumerable.take", function( assert ) { const result = Enumerable.from([1,2,3,4,5]).take(2).toArray(); assert.deepEqual( result,[1,2], "Passed!" ); }); QUnit.test( "Enumerable.takeLast array", function( assert ) { const result = Enumerable.from([1,2,3,4,5]).takeLast(2).toArray(); assert.deepEqual( result,[4,5], "Passed!" ); }); QUnit.test( "Enumerable.takeLast generator", function( assert ) { function* gen() { yield 1; yield 2; yield 3; yield 4; yield 5; } const result = Enumerable.from(gen()).takeLast(2).toArray(); assert.deepEqual( result,[4,5], "Passed!" ); }); QUnit.test( "Enumerable.takeWhile", function( assert ) { const result = Enumerable.from([1,2,3,2,1]).takeWhile(item=>item<3).toArray(); assert.deepEqual( result,[1,2], "Passed!" ); }); QUnit.test( "Enumerable.toMap", function( assert ) { const result = Enumerable.from([1,2,3,4,5]).toMap(item=>item,item=>item*item); assert.deepEqual( result,new Map([[1,1],[2,4],[3,9],[4,16],[5,25]]), "Passed!" ); }); QUnit.test( "Enumerable.toObject", function( assert ) { const result = Enumerable.from([1,2,3,4,5]).toObject(item=>'k'+item); assert.deepEqual( result,{k1:1,k2:2,k3:3,k4:4,k5:5}, "Passed!" ); }); QUnit.test( "Enumerable.toSet", function( assert ) { const result = Enumerable.from([1,2,3,4,5]).toSet(); assert.deepEqual( result,new Set([1,2,3,4,5]), "Passed!" ); }); QUnit.test( "Enumerable.union", function( assert ) { const result = Enumerable.from([1,1,2]).union([3,2]).toArray(); assert.deepEqual( result,[1,2,3], "Passed!" ); }); QUnit.test( "Enumerable.union equality comparer", function( assert ) { const result = Enumerable.from([11,12,26]).union([31,23],(i1,i2)=>(i1+'').charAt(0)===(i2+'').charAt(0)).toArray(); assert.deepEqual( result,[11,26,31], "Passed!" ); }); QUnit.test( "Enumerable.where", function( assert ) { const result = Enumerable.from([1,2,3,4,5]).where(item=>item%2).toArray(); assert.deepEqual( result,[1,3,5], "Passed!" ); }); QUnit.test( "Enumerable.where with index", function( assert ) { const idxs=[]; const result = Enumerable.from([1,2,3,4,5]).where((item,index)=>{ idxs.push(index); return item%2; }).toArray(); assert.deepEqual( result,[1,3,5], "Passed!" ); assert.deepEqual( idxs,[0,1,2,3,4], "Passed!" ); }); QUnit.test( "Enumerable.zip", function( assert ) { const result = Enumerable.from([1,2,3,4]).zip(['a','b','c'],(i1,i2)=>i2+' '+i1).toArray(); assert.deepEqual( result,['a 1','b 2','c 3'], "Passed!" ); }); QUnit.test( "Enumerable.zip with index", function( assert ) { const idxs=[]; const result = Enumerable.from([1,2,3,4]).zip(['a','b','c'],(i1,i2,index)=>{ idxs.push(index); return i2+' '+i1; }).toArray(); assert.deepEqual( result,['a 1','b 2','c 3'], "Passed!" ); assert.deepEqual( idxs,[0, 1, 2], "Passed!" ); }); // OrderedEnumerable tests QUnit.module('OrderedEnumerable tests'); QUnit.test( "OrderedEnumerable.thenBy", function( assert ) { const result = Enumerable.from([1,2,3,4]).orderBy(i=>i%2==0).thenBy(i=>-i).toArray(); assert.deepEqual( result,[3,1,4,2], "Passed!" ); }); QUnit.test( "OrderedEnumerable.thenByDescending", function( assert ) { const result = Enumerable.from([1,2,3,4]).orderByDescending(i=>i%2==0).thenByDescending(i=>-i).toArray(); assert.deepEqual( result,[2,4,1,3], "Passed!" ); }); QUnit.test( "OrderedEnumerable.thenByDescending and thenBy and select QuickSort", function( assert ) { let result = Enumerable.from(['a1','a2','a3','b1','b2','c1','c3']) .useQuickSort() .orderBy(i=>0) .thenByDescending(i=>i.charAt(1)) .thenBy(i=>i.charAt(0)=='b') .select(i=>'x'+i) .toArray(); //assert.deepEqual( result,['xa3','xc3','xa2','xb2','xc1','xa1','xb1'], "Passed!" ); assert.deepEqual( result.map(i=>i.charAt(2)),['3','3','2','2','1','1','1'], "Passed!" ); assert.deepEqual( result[3].charAt(1),'b', "Passed!" ); assert.deepEqual( result[6].charAt(1),'b', "Passed!" ); }); QUnit.test( "OrderedEnumerable.thenByDescending and thenBy and select default sort", function( assert ) { const result = Enumerable.from(['a1','a2','a3','b1','b2','c1','c3']) .useBrowserSort() .orderBy(i=>0) .thenByDescending(i=>i.charAt(1)) .thenBy(i=>i.charAt(0)=='b') .select(i=>'x'+i) .toArray(); assert.deepEqual( result,['xa3','xc3','xa2','xb2','xa1','xc1','xb1'], "Passed!" ); }); QUnit.test( "OrderedEnumerable then take", function( assert ) { const result = Enumerable.from([3,2,1,4]).orderBy().take(2).toArray(); assert.deepEqual( result,[1,2], "Passed!" ); }); QUnit.test( "OrderedEnumerable then skip", function( assert ) { const result = Enumerable.from([3,2,1,4]).orderBy().skip(2).toArray(); assert.deepEqual( result,[3,4], "Passed!" ); }); QUnit.test( "OrderedEnumerable then takeLast", function( assert ) { const result = Enumerable.from([3,2,1,4]).orderBy().takeLast(2).toArray(); assert.deepEqual( result,[3,4], "Passed!" ); }); QUnit.test( "OrderedEnumerable then skipLast", function( assert ) { const result = Enumerable.from([3,2,1,4]).orderBy().take(2).toArray(); assert.deepEqual( result,[1,2], "Passed!" ); }); QUnit.test( "OrderedEnumerable with multiple restrictions", function( assert ) { const result = Enumerable.from([3,2,1,4,6,5,9,8,7,0]).orderBy().skip(2).take(7).skipLast(3).takeLast(2); assert.deepEqual(result._wasIterated,false,"Passed!"); const arr = result.toArray(); assert.deepEqual( arr,[4,5], "Passed!" ); }); QUnit.test( "Enumerable.sort in place", function( assert ) { const arr = [1,2,3,4]; const result = Enumerable.sort(arr, i=>i%2==1); assert.deepEqual( arr, result, "Passed!" ); assert.deepEqual( arr.map(i=>i%2),[0,0,1,1], "Passed!" ); }); // repeat tests QUnit.module('repeat tests'); QUnit.test( "Enumerable.range repeat", function( assert ) { const result = Enumerable.range(1,3); assert.deepEqual( Array.from(result),[1,2,3], "Passed!" ); assert.deepEqual( Array.from(result),[1,2,3], "Passed!" ); }); QUnit.test( "Enumerable.take repeat", function( assert ) { const result = Enumerable.from([1,2,3,4,5,6,7,8,9]).take(3); assert.deepEqual( Array.from(result),[1,2,3], "Passed!" ); assert.deepEqual( Array.from(result),[1,2,3], "Passed!" ); }); QUnit.test( "Enumerable.take repeat", function( assert ) { const result = Enumerable.from([3,2,1]).reverse(); assert.deepEqual( Array.from(result),[1,2,3], "Passed!" ); assert.deepEqual( Array.from(result),[1,2,3], "Passed!" ); }); QUnit.test( "Enumerable.take orderBy", function( assert ) { const result = Enumerable.from([2,4,5,3,1]).orderBy(); assert.deepEqual( Array.from(result),[1,2,3,4,5], "Passed!" ); assert.deepEqual( Array.from(result),[1,2,3,4,5], "Passed!" ); }); QUnit.test( "Enumerable.take orderBy take", function( assert ) { const result = Enumerable.from([2,4,5,3,1]).orderBy().skip(1).take(3); assert.deepEqual( Array.from(result),[2,3,4], "Passed!" ); assert.deepEqual( Array.from(result),[2,3,4], "Passed!" ); }); // composable count tests QUnit.module('composable count tests'); QUnit.test( "Enumerable.empty count", function( assert ) { const result = Enumerable.empty(); assert.deepEqual( result.elementAtOrDefault(1), undefined, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "Enumerable.repeat count", function( assert ) { const result = Enumerable.repeat(100,1000000000); assert.deepEqual( result.elementAtOrDefault(12345), 100, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "Enumerable.range count", function( assert ) { const result = Enumerable.range(100,1000000000); assert.deepEqual( result.elementAtOrDefault(12345), 12445, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "Enumerable.concat seekable count ", function( assert ) { const result = Enumerable.range(100,10000).concat(Enumerable.repeat(10,20000)); assert.deepEqual( result.count(), 30000, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "Enumerable.concat unseekable count", function( assert ) { const iterable = Enumerable.from(function*(){ yield 1; }) const result = Enumerable.range(100,10000).concat(iterable); assert.deepEqual( result.count(), 10001, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); assert.deepEqual( iterable._wasIterated, true, "Passed!" ); }); QUnit.test( "orderBy count", function( assert ) { const result = Enumerable.range(100,10000).orderBy(i=>i+1); assert.deepEqual( result.count(), 10000, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "reverse count", function( assert ) { const result = Enumerable.range(100,10000).reverse(); assert.deepEqual( result.count(), 10000, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "skip count", function( assert ) { const result = Enumerable.range(100,10000).skip(5); assert.deepEqual( result.count(), 9995, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "skipLast count", function( assert ) { const result = Enumerable.range(100,10000).skipLast(5); assert.deepEqual( result.count(), 9995, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "take count", function( assert ) { const result = Enumerable.range(100,10000).take(5); assert.deepEqual( result.count(), 5, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "takeLast count", function( assert ) { const result = Enumerable.range(100,10000).takeLast(5); assert.deepEqual( result.count(), 5, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "OrderedEnumerable with multiple restrictions count", function( assert ) { let result = Enumerable.from([3,2,1,4,6,5,9,8,7,0]).orderBy(); assert.deepEqual(result._wasIterated,false,"Passed!"); assert.deepEqual(result.count(),10,"Passed!"); assert.deepEqual(result._wasIterated,false,"Passed!"); result = result.skip(2).take(7).skipLast(3).takeLast(2); assert.deepEqual(result._wasIterated,false,"Passed!"); assert.deepEqual(result.count(),2,"Passed!"); assert.deepEqual(result._wasIterated,false,"Passed!"); }); // seek tests QUnit.module('seek tests'); QUnit.test( "Enumerable.empty seek", function( assert ) { const result = Enumerable.empty(); assert.deepEqual( result.count(), 0, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(10000), undefined, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "Enumerable.range seek", function( assert ) { const result = Enumerable.range(0,100000); assert.deepEqual( result.count(), 100000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(10000), 10000, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "Enumerable.repeat seek", function( assert ) { const result = Enumerable.repeat(123,100000); assert.deepEqual( result.count(), 100000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(10000), 123, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "append seek", function( assert ) { const result = Enumerable.range(0,100000).append(666666); assert.deepEqual( result.count(), 100001, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(100000), 666666, "Passed!" ); assert.deepEqual( result.first(), 0, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "concat array seek", function( assert ) { const result = Enumerable.range(0,100000).concat([0,1,2,3,4,5]); assert.deepEqual( result.count(), 100006, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(100004), 4, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "concat Enumerable seek", function( assert ) { const result = Enumerable.range(0,100000).concat(Enumerable.range(0,6)); assert.deepEqual( result.count(), 100006, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(100004), 4, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "prepend seek", function( assert ) { const result = Enumerable.range(0,100000).prepend(666666); assert.deepEqual( result.count(), 100001, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(100000), 99999, "Passed!" ); assert.deepEqual( result.first(), 666666, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "reverse seek", function( assert ) { const result = Enumerable.range(0,100000).reverse(); assert.deepEqual( result.count(), 100000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(10000), 89999, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "select seek", function( assert ) { const result = Enumerable.range(0,100000).select(i=>'a'+i); assert.deepEqual( result.count(), 100000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(10000), 'a10000', "Passed!" ); assert.deepEqual( result.elementAtOrDefault(1000000), undefined, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "skip seek", function( assert ) { const result = Enumerable.range(0,100000).skip(50000); assert.deepEqual( result.count(), 50000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(10000), 60000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(1000000), undefined, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "skipLast seek", function( assert ) { const result = Enumerable.range(0,100000).skipLast(50000); assert.deepEqual( result.count(), 50000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(10000), 10000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(50000), undefined, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(1000000), undefined, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "take seek", function( assert ) { const result = Enumerable.range(0,100000).take(50000); assert.deepEqual( result.count(), 50000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(10000), 10000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(50000), undefined, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(1000000), undefined, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "skip takeLast", function( assert ) { const result = Enumerable.range(0,100000).takeLast(50000); assert.deepEqual( result.count(), 50000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(10000), 60000, "Passed!" ); assert.deepEqual( result.elementAtOrDefault(1000000), undefined, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); // Extra features QUnit.module('Extra features'); QUnit.test( "Enumerable.shuffle", function( assert ) { const result = Enumerable.range(1,10).shuffle(); assert.deepEqual(result._wasIterated, false,'Passed!'); let arr = result.toArray(); assert.deepEqual(result._wasIterated, true,'Passed!'); assert.notDeepEqual(arr, Enumerable.range(1,10).toArray(),'Passed!'); arr = result.toArray().sort((i1,i2)=>i1-i2); assert.deepEqual(arr, Enumerable.range(1,10).toArray(),'Passed!'); }); QUnit.test( "shuffle count", function( assert ) { const result = Enumerable.range(100,10000).shuffle(); assert.deepEqual( result.count(), 10000, "Passed!" ); assert.deepEqual( result._wasIterated, false, "Passed!" ); }); QUnit.test( "Enumerable.randomSample canSeek", function( assert ) { const result = Enumerable.range(1,100000).randomSample(100); const avg = Math.round(result.average()); assert.deepEqual(result.count(),100,"Sample average is "+avg+" and it should be close to 50000"); }); QUnit.test( "Enumerable.randomSample no canSeek", function( assert ) { const result = Enumerable.from(function*() { for (let i=0; i<100000; i++) yield i; }).randomSample(100); const avg = Math.round(result.average()); assert.deepEqual(result.count(),100,"Sample average is "+avg+" and it should be close to 50000"); }); QUnit.test( "Enumerable.randomSample no canSeek limit", function( assert ) { const result = Enumerable.from(function*() { let i=0; while (true) { yield i; if (i>100000) { throw Error('It should never go above the limit of 100000') } i++; } }).randomSample(100,100000); const avg = Math.round(result.average()); assert.deepEqual(result.count(),100,"Sample average is "+avg+" and it should be close to 50000"); }); QUnit.test( "Enumerable.binarySearch", function( assert ) { const result = Enumerable.range(1,10).select(i=>i*10).orderBy(); assert.deepEqual(result._wasIterated, false,'Passed!'); let index = result.binarySearch(80); assert.deepEqual(result._wasIterated, false,'Passed!'); assert.deepEqual(index, 7,'Passed!'); index = result.binarySearch(45); assert.deepEqual(index, false,'Passed!'); }); QUnit.test( "Enumerable.distinctByHash", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).distinctByHash(i=>+i).toArray(); assert.deepEqual( result,[1,2,3], "Passed!" ); }); QUnit.test( "Enumerable.exceptByHash", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).exceptByHash([2,3],i=>+i).toArray(); assert.deepEqual( result,[1], "Passed!" ); }); QUnit.test( "Enumerable.intersectByHash", function( assert ) { const result = Enumerable.from([1,2,2,3,'3']).intersectByHash([2,3],i=>+i).toArray(); assert.deepEqual( result,[2,2,3,'3'], "Passed!" ); }); QUnit.test( "Enumerable.lag canSeek", function( assert ) { const result = Enumerable.from([1,2,3,4,5,6]).lag(1,(i1,i2)=>i1+''+i2).toArray(); assert.deepEqual( result,['1undefined','21','32','43','54','65'], "Passed!" ); }); QUnit.test( "Enumerable.lead canSeek", function( assert ) { const result = Enumerable.from([1,2,3,4,5,6]).lead(1,(i1,i2)=>i1+''+i2).toArray(); assert.deepEqual( result,['12','23','34','45','56','6undefined'], "Passed!" ); }); QUnit.test( "Enumerable.lag no canSeek", function( assert ) { const result = Enumerable.from(function*() { for (const item of [1,2,3,4,5,6]) yield item; }).lag(1,(i1,i2)=>i1+''+i2).toArray(); assert.deepEqual( result,['1undefined','21','32','43','54','65'], "Passed!" ); }); QUnit.test( "Enumerable.lead no canSeek", function( assert ) { const result = Enumerable.from(function*() { for (const item of [1,2,3,4,5,6]) yield item; }).lead(1,(i1,i2)=>i1+''+i2).toArray(); assert.deepEqual( result,['12','23','34','45','56','6undefined'], "Passed!" ); }); QUnit.test( "Enumerable.lag no canSeek 2", function( assert ) { const result = Enumerable.from(function*() { for (const item of [1,2,3,4,5,6]) yield item; }).lag(2,(i1,i2)=>i1+''+i2).toArray(); assert.deepEqual( result,['1undefined','2undefined','31','42','53','64'], "Passed!" ); }); QUnit.test( "Enumerable.lead no canSeek 2", function( assert ) { const result = Enumerable.from(function*() { for (const item of [1,2,3,4,5,6]) yield item; }).lead(2,(i1,i2)=>i1+''+i2).toArray(); assert.deepEqual( result,['13','24','35','46','5undefined','6undefined'], "Passed!" ); }); QUnit.test( "Enumerable.lag canSeek count", function( assert ) { const result = Enumerable.from([1,2,3,4,5,6]).lag(1,(i1,i2)=>i1+''+i2); assert.deepEqual( result.count(),6, "Passed!" ); assert.deepEqual( result._wasIterated,false, "Passed!" ); }); QUnit.test( "Enumerable.lead canSeek count", function( assert ) { const result = Enumerable.from([1,2,3,4,5,6]).lead(1,(i1,i2)=>i1+''+i2); assert.deepEqual( result.count(),6, "Passed!" ); assert.deepEqual( result._wasIterated,false, "Passed!" ); }); QUnit.test( "Enumerable.lag no canSeek count", function( assert ) { const result = Enumerable.from(function*() { for (const item of [1,2,3,4,5,6]) yield item; }).lag(1,(i1,i2)=>i1+''+i2); assert.deepEqual( result.count(),6, "Passed!" ); assert.deepEqual( result._wasIterated,true, "Passed!" ); }); QUnit.test( "Enumerable.lag canSeek elementAt", function( assert ) { const result = Enumerable.from([1,2,3,4,5,6]).lag(1,(i1,i2)=>i1+''+i2); assert.deepEqual( result.elementAt(1),'21', "Passed!" ); assert.deepEqual( result._wasIterated,false, "Passed!" ); }); QUnit.test( "Enumerable.lag no canSeek count", function( assert ) { const result = Enumerable.from(function*() { for (const item of [1,2,3,4,5,6]) yield item; }).lag(1,(i1,i2)=>i1+''+i2); assert.deepEqual( result.elementAt(1),'21', "Passed!" ); assert.deepEqual( result._wasIterated,true, "Passed!" ); }); QUnit.test( "Enumerable.padEnd canSeek value", function( assert ) { const result = Enumerable.from([1,2,3]).padEnd(5,16).toArray(); assert.deepEqual( result,[1,2,3,16,16], "Passed!" ); }); QUnit.test( "Enumerable.padEnd canSeek func", function( assert ) { const result = Enumerable.from([1,2,3]).padEnd(5,i=>i+11).toArray(); assert.deepEqual( result,[1,2,3,14,15], "Passed!" ); }); QUnit.test( "Enumerable.padEnd canSeek func count", function( assert ) { const result = Enumerable.from([1,2,3]).padEnd(5,i=>i+11); assert.deepEqual( result.count(),5, "Passed!" ); assert.deepEqual( result._wasIterated,false, "Passed!" ); }); QUnit.test( "Enumerable.padEnd canSeek func elementAt", function( assert ) { const result = Enumerable.from([1,2,3]).padEnd(5,i=>i+11); assert.deepEqual( result.elementAt(4),15, "Passed!" ); assert.deepEqual( result._wasIterated,false, "Passed!" ); }); QUnit.test( "Enumerable.padEnd no canSeek func elementAt", function( assert ) { const result = Enumerable.from(function*() { for (const item of [1,2,3]) yield item; }).padEnd(5,i=>i+11); assert.deepEqual( result.elementAt(4),15, "Passed!" ); assert.deepEqual( result._wasIterated,true, "Passed!" ); }); QUnit.test( "Enumerable.padStart canSeek value", function( assert ) { const result = Enumerable.from([1,2,3]).padStart(5,16).toArray(); assert.deepEqual( result,[16,16,1,2,3], "Passed!" ); }); QUnit.test( "Enumerable.padStart canSeek func", function( assert ) { const result = Enumerable.from([1,2,3]).padStart(5,i=>i+11).toArray(); assert.deepEqual( result,[11,12,1,2,3], "Passed!" ); }); QUnit.test( "Enumerable.padStart canSeek func count", function( assert ) { const result = Enumerable.from([1,2,3]).padStart(5,i=>i+11); assert.deepEqual( result.count(),5, "Passed!" ); assert.deepEqual( result._wasIterated,false, "Passed!" ); }); QUnit.test( "Enumerable.padStart canSeek func elementAt", function( assert ) { const result = Enumerable.from([1,2,3]).padStart(5,i=>i+11); assert.deepEqual( result.elementAt(4),3, "Passed!" ); assert.deepEqual( result.elementAt(1),12, "Passed!" ); assert.deepEqual( result._wasIterated,false, "Passed!" ); }); QUnit.test( "Enumerable.padStart no canSeek func elementAt", function( assert ) { const result = Enumerable.from(function*() { for (const item of [1,2,3]) yield item; }).padStart(5,i=>i+11); assert.deepEqual( result.elementAt(4),3, "Passed!" ); assert.deepEqual( result.elementAt(1),12, "Passed!" ); assert.deepEqual( result._wasIterated,true, "Passed!" ); }); QUnit.test( "GitHub issue #22", function( assert ) { const result = Enumerable.from([{ a: [1,2] }, { a: [2,3,4] }]).selectMany(x => x.a).toArray(); assert.deepEqual( result,[1,2,2,3,4], "Passed!" ); }); ================================================ FILE: tests.performance.html ================================================ Performance tests for LInQer
      ================================================ FILE: tests.performance.js ================================================ Enumerable = Linqer.Enumerable; const largeNumber = 10000000; // performance tests QUnit.module('performance tests'); QUnit.test( "Use only items that are required - standard", function( assert ) { const largeArray = Array(largeNumber).fill(10); const startTime = performance.now(); const someCalculation = largeArray.filter(x=>x===10).map(x=>'v'+x).slice(100,110); Array.from(someCalculation); const endTime = performance.now(); assert.ok(true,'Standard array use took '+(endTime-startTime)+'milliseconds'); }); QUnit.test( "Use only items that are required - Enumerable", function( assert ) { const largeArray = Array(largeNumber).fill(10); const startTime = performance.now(); const someCalculation = Enumerable.from(largeArray).where(x=>x===10).select(x=>'v'+x).skip(100).take(10).toArray(); Array.from(someCalculation); const endTime = performance.now(); assert.ok(true,'Enumerable use took '+(endTime-startTime)+'milliseconds'); }); QUnit.test( "OrderBy performance random", function( assert ) { const size = largeNumber; const largeArray1 = Enumerable.range(1,size).shuffle().toArray(); let startTime = performance.now(); const result1 = Array.from(largeArray1).sort((i1,i2)=>i2-i1); let endTime = performance.now(); assert.ok(true,'Order '+size+' items using Array.from then .sort took '+(endTime-startTime)+' milliseconds'); startTime = performance.now(); const result2 = Enumerable.from(largeArray1).orderBy(i=>size-i).useBrowserSort().toArray(); endTime = performance.now(); assert.ok(true,'Order '+size+' items using browser sort internally took '+(endTime-startTime)+' milliseconds'); for (let i=0; isize-i).useBrowserSort().toArray(); endTime = performance.now(); assert.ok(true,'Order '+size+' items using browser sort internally took '+(endTime-startTime)+' milliseconds'); for (let i=0; isize-i).useBrowserSort().toArray(); endTime = performance.now(); assert.ok(true,'Order '+size+' items using browser sort internally took '+(endTime-startTime)+' milliseconds'); for (let i=0; isize-i).skip(100000).take(10000).toArray(); endTime = performance.now(); assert.ok(true,'Order '+size+' items skip and take using QuickSort took '+(endTime-startTime)+' milliseconds'); for (let i=0; i +(i1) === +(i2)).toArray(); assert.deepEqual(result, [1, 2, 3], "Passed!"); }); QUnit.test("Enumerable.elementAt in range array", function (assert) { const result = Enumerable.from([1, 2, 2, 3, '3']).elementAt(3); assert.deepEqual(result, 3, "Passed!"); }); QUnit.test("Enumerable.elementAt below range array", function (assert) { assert.throws(() => Enumerable.from([1, 2, 2, 3, '3']).elementAt(-3), "Passed!"); }); QUnit.test("Enumerable.elementAt above range array", function (assert) { assert.throws(() => Enumerable.from([1, 2, 2, 3, '3']).elementAt(30), "Passed!"); }); QUnit.test("Enumerable.elementAtOrDefault in range array", function (assert) { const result = Enumerable.from([1, 2, 2, 3, '3']).elementAtOrDefault(3); assert.deepEqual(result, 3, "Passed!"); }); QUnit.test("Enumerable.elementAtOrDefault below range array", function (assert) { const result = Enumerable.from([1, 2, 2, 3, '3']).elementAtOrDefault(-3); assert.deepEqual(result, undefined, "Passed!"); }); QUnit.test("Enumerable.elementAtOrDefault above range array", function (assert) { const result = Enumerable.from([1, 2, 2, 3, '3']).elementAtOrDefault(30); assert.deepEqual(result, undefined, "Passed!"); }); QUnit.test("Enumerable.first", function (assert) { const result = Enumerable.from([1, 2, 2, 3, '3']).first(); assert.deepEqual(result, 1, "Passed!"); }); QUnit.test("Enumerable.first empty", function (assert) { assert.throws(() => Enumerable.from([]).first(), "Passed!"); }); QUnit.test("Enumerable.firstOrDefault", function (assert) { const result = Enumerable.from([]).firstOrDefault(); assert.deepEqual(result, undefined, "Passed!"); }); QUnit.test("Enumerable.last", function (assert) { const result = Enumerable.from([1, 2, 2, 3, '3']).last(); assert.deepEqual(result, '3', "Passed!"); }); QUnit.test("Enumerable.last empty", function (assert) { assert.throws(() => Enumerable.from([]).last(), "Passed!"); }); QUnit.test("Enumerable.lastOrDefault", function (assert) { const result = Enumerable.from([]).lastOrDefault(); assert.deepEqual(result, undefined, "Passed!"); }); QUnit.test("Enumerable.max numbers", function (assert) { const result = Enumerable.from([3, 5, 1, 2, 56, 2, -100, 43]).max(); assert.deepEqual(result, 56, "Passed!"); }); QUnit.test("Enumerable.max strings", function (assert) { const result = Enumerable.from(['ba', 'a', 'abba', 'aaa', 'bb']).max(); assert.deepEqual(result, 'bb', "Passed!"); }); QUnit.test("Enumerable.min number", function (assert) { const result = Enumerable.from([3, 5, 1, 2, 56, 2, -100, 43]).min(); assert.deepEqual(result, -100, "Passed!"); }); QUnit.test("Enumerable.min custom comparer", function (assert) { const result = Enumerable.from([3, 5, 1, 2, 56, 2, -100, 43]).min((i1, i2) => i1.toString().length - i2.toString().length); assert.deepEqual(result, 3, "Passed!"); }); QUnit.test("Enumerable.select", function (assert) { const result = Enumerable.from(['a', 1, 3, 2]).select(item => Number.isInteger(item) ? item * item : item + '^2').toArray(); assert.deepEqual(result, ['a^2', 1, 9, 4], "Passed!"); }); QUnit.test("Enumerable.skip", function (assert) { const result = Enumerable.from([1, 2, 3, 4, 5]).skip(2).toArray(); assert.deepEqual(result, [3, 4, 5], "Passed!"); }); QUnit.test("Enumerable.sum numbers", function (assert) { const result = Enumerable.from([1, 2, 3, 4, 5]).sum(); assert.deepEqual(result, 15, "Passed!"); }); QUnit.test("Enumerable.sum numbers with some strings", function (assert) { const result = Enumerable.from([1, 2, 3, 4, 5, '6']).sum(); assert.deepEqual(result, Number.NaN, "Passed!"); }); QUnit.test("Enumerable.take", function (assert) { const result = Enumerable.from([1, 2, 3, 4, 5]).take(2).toArray(); assert.deepEqual(result, [1, 2], "Passed!"); }); QUnit.test("Enumerable.where", function (assert) { const result = Enumerable.from([1, 2, 3, 4, 5]).where(item => item % 2).toArray(); assert.deepEqual(result, [1, 3, 5], "Passed!"); }); QUnit.test("Enumerable.where with index", function (assert) { const idxs = []; const result = Enumerable.from([1, 2, 3, 4, 5]).where((item, index) => { idxs.push(index); return item % 2; }).toArray(); assert.deepEqual(result, [1, 3, 5], "Passed!"); assert.deepEqual(idxs, [0, 1, 2, 3, 4], "Passed!"); }); // composable count tests QUnit.module('composable count tests'); QUnit.test("Enumerable.concat seekable count ", function (assert) { const result = Enumerable.range(100, 10000).concat(Enumerable.range(10, 20000)); assert.deepEqual(result.count(), 30000, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); }); QUnit.test("Enumerable.concat unseekable count", function (assert) { const iterable = Enumerable.from(function* () { yield 1; }) const result = Enumerable.range(100, 10000).concat(iterable); assert.deepEqual(result.count(), 10001, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); assert.deepEqual(iterable._wasIterated, true, "Passed!"); }); QUnit.test("skip count", function (assert) { const result = Enumerable.range(100, 10000).skip(5); assert.deepEqual(result.count(), 9995, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); }); QUnit.test("take count", function (assert) { const result = Enumerable.range(100, 10000).take(5); assert.deepEqual(result.count(), 5, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); }); // seek tests QUnit.module('seek tests'); QUnit.test("Enumerable.empty seek", function (assert) { const result = Enumerable.from([]); assert.deepEqual(result.count(), 0, "Passed!"); assert.deepEqual(result.elementAtOrDefault(10000), undefined, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); }); QUnit.test("concat array seek", function (assert) { const result = Enumerable.range(0, 100000).concat([0, 1, 2, 3, 4, 5]); assert.deepEqual(result.count(), 100006, "Passed!"); assert.deepEqual(result.elementAtOrDefault(100004), 4, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); }); QUnit.test("concat Enumerable seek", function (assert) { const result = Enumerable.range(0, 100000).concat(Enumerable.range(0, 6)); assert.deepEqual(result.count(), 100006, "Passed!"); assert.deepEqual(result.elementAtOrDefault(100004), 4, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); }); QUnit.test("select seek", function (assert) { const result = Enumerable.range(0, 100000).select(i => 'a' + i); assert.deepEqual(result.count(), 100000, "Passed!"); assert.deepEqual(result.elementAtOrDefault(10000), 'a10000', "Passed!"); assert.deepEqual(result.elementAtOrDefault(1000000), undefined, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); }); QUnit.test("skip seek", function (assert) { const result = Enumerable.range(0, 100000).skip(50000); assert.deepEqual(result.count(), 50000, "Passed!"); assert.deepEqual(result.elementAtOrDefault(10000), 60000, "Passed!"); assert.deepEqual(result.elementAtOrDefault(1000000), undefined, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); }); QUnit.test("take seek", function (assert) { const result = Enumerable.range(0, 100000).take(50000); assert.deepEqual(result.count(), 50000, "Passed!"); assert.deepEqual(result.elementAtOrDefault(10000), 10000, "Passed!"); assert.deepEqual(result.elementAtOrDefault(50000), undefined, "Passed!"); assert.deepEqual(result.elementAtOrDefault(1000000), undefined, "Passed!"); assert.deepEqual(result._wasIterated, false, "Passed!"); }); ================================================ FILE: tsconfig.all.json ================================================ { "compilerOptions": { /* Basic Options */ // "incremental": true, /* Enable incremental compilation */ "target": "es6", /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */ "module": "system", /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */ // "lib": [], /* Specify library files to be included in the compilation. */ // "allowJs": true, /* Allow javascript files to be compiled. */ // "checkJs": true, /* Report errors in .js files. */ // "jsx": "preserve", /* Specify JSX code generation: 'preserve', 'react-native', or 'react'. */ "declaration": true, /* Generates corresponding '.d.ts' file. */ // "declarationMap": true, /* Generates a sourcemap for each corresponding '.d.ts' file. */ // "sourceMap": true, /* Generates corresponding '.map' file. */ "outFile": "./LInQer.all.js", /* Concatenate and emit output to single file. */ // "outDir": "./", /* Redirect output structure to the directory. */ // "rootDir": "./", /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */ // "composite": true, /* Enable project compilation */ // "tsBuildInfoFile": "./", /* Specify file to store incremental compilation information */ // "removeComments": true, /* Do not emit comments to output. */ // "noEmit": true, /* Do not emit outputs. */ // "importHelpers": true, /* Import emit helpers from 'tslib'. */ // "downlevelIteration": true, /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */ // "isolatedModules": true, /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */ /* Strict Type-Checking Options */ "strict": true, /* Enable all strict type-checking options. */ "noImplicitAny": true, /* Raise error on expressions and declarations with an implied 'any' type. */ "strictNullChecks": true, /* Enable strict null checks. */ "strictFunctionTypes": true, /* Enable strict checking of function types. */ "strictBindCallApply": true, /* Enable strict 'bind', 'call', and 'apply' methods on functions. */ "strictPropertyInitialization": true, /* Enable strict checking of property initialization in classes. */ "noImplicitThis": true, /* Raise error on 'this' expressions with an implied 'any' type. */ "alwaysStrict": true, /* Parse in strict mode and emit "use strict" for each source file. */ /* Additional Checks */ // "noUnusedLocals": true, /* Report errors on unused locals. */ // "noUnusedParameters": true, /* Report errors on unused parameters. */ // "noImplicitReturns": true, /* Report error when not all code paths in function return a value. */ // "noFallthroughCasesInSwitch": true, /* Report errors for fallthrough cases in switch statement. */ /* Module Resolution Options */ "moduleResolution": "node", /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */ // "baseUrl": "./", /* Base directory to resolve non-absolute module names. */ // "paths": {}, /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */ // "rootDirs": [], /* List of root folders whose combined content represents the structure of the project at runtime. */ // "typeRoots": [], /* List of folders to include type definitions from. */ // "types": [], /* Type declaration files to be included in compilation. */ // "allowSyntheticDefaultImports": true, /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */ "esModuleInterop": true, /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */ // "preserveSymlinks": true, /* Do not resolve the real path of symlinks. */ // "allowUmdGlobalAccess": true, /* Allow accessing UMD globals from modules. */ /* Source Map Options */ // "sourceRoot": "", /* Specify the location where debugger should locate TypeScript files instead of source locations. */ // "mapRoot": "", /* Specify the location where debugger should locate map files instead of generated locations. */ // "inlineSourceMap": true, /* Emit a single file with source maps instead of having a separate file. */ // "inlineSources": true, /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */ /* Experimental Options */ "experimentalDecorators": true, /* Enables experimental support for ES7 decorators. */ "emitDecoratorMetadata": true, /* Enables experimental support for emitting type metadata for decorators. */ /* Advanced Options */ "forceConsistentCasingInFileNames": true /* Disallow inconsistently-cased references to the same file. */ }, "compileOnSave": true, "files": ["./LInQer.Slim.ts","./LInQer.Enumerable.ts","./LInQer.GroupEnumerable.ts","./LInQer.OrderedEnumerable.ts","./LInQer.Extra.ts","./npm.export.ts"] } ================================================ FILE: tsconfig.extra.json ================================================ { "compilerOptions": { /* Basic Options */ // "incremental": true, /* Enable incremental compilation */ "target": "es6", /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */ "module": "system", /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */ // "lib": [], /* Specify library files to be included in the compilation. */ // "allowJs": true, /* Allow javascript files to be compiled. */ // "checkJs": true, /* Report errors in .js files. */ // "jsx": "preserve", /* Specify JSX code generation: 'preserve', 'react-native', or 'react'. */ // "declaration": true, /* Generates corresponding '.d.ts' file. */ // "declarationMap": true, /* Generates a sourcemap for each corresponding '.d.ts' file. */ // "sourceMap": true, /* Generates corresponding '.map' file. */ // "outFile": "./LInQer.extra.js", /* Concatenate and emit output to single file. */ // "outDir": "./", /* Redirect output structure to the directory. */ // "rootDir": "./", /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */ // "composite": true, /* Enable project compilation */ // "tsBuildInfoFile": "./", /* Specify file to store incremental compilation information */ // "removeComments": true, /* Do not emit comments to output. */ // "noEmit": true, /* Do not emit outputs. */ // "importHelpers": true, /* Import emit helpers from 'tslib'. */ // "downlevelIteration": true, /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */ // "isolatedModules": true, /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */ /* Strict Type-Checking Options */ "strict": true, /* Enable all strict type-checking options. */ "noImplicitAny": true, /* Raise error on expressions and declarations with an implied 'any' type. */ "strictNullChecks": true, /* Enable strict null checks. */ "strictFunctionTypes": true, /* Enable strict checking of function types. */ "strictBindCallApply": true, /* Enable strict 'bind', 'call', and 'apply' methods on functions. */ "strictPropertyInitialization": true, /* Enable strict checking of property initialization in classes. */ "noImplicitThis": true, /* Raise error on 'this' expressions with an implied 'any' type. */ "alwaysStrict": true, /* Parse in strict mode and emit "use strict" for each source file. */ /* Additional Checks */ // "noUnusedLocals": true, /* Report errors on unused locals. */ // "noUnusedParameters": true, /* Report errors on unused parameters. */ // "noImplicitReturns": true, /* Report error when not all code paths in function return a value. */ // "noFallthroughCasesInSwitch": true, /* Report errors for fallthrough cases in switch statement. */ /* Module Resolution Options */ // "moduleResolution": "node", /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */ // "baseUrl": "./", /* Base directory to resolve non-absolute module names. */ // "paths": {}, /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */ // "rootDirs": [], /* List of root folders whose combined content represents the structure of the project at runtime. */ // "typeRoots": [], /* List of folders to include type definitions from. */ // "types": [], /* Type declaration files to be included in compilation. */ // "allowSyntheticDefaultImports": true, /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */ "esModuleInterop": true, /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */ // "preserveSymlinks": true, /* Do not resolve the real path of symlinks. */ // "allowUmdGlobalAccess": true, /* Allow accessing UMD globals from modules. */ /* Source Map Options */ // "sourceRoot": "", /* Specify the location where debugger should locate TypeScript files instead of source locations. */ // "mapRoot": "", /* Specify the location where debugger should locate map files instead of generated locations. */ // "inlineSourceMap": true, /* Emit a single file with source maps instead of having a separate file. */ // "inlineSources": true, /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */ /* Experimental Options */ "experimentalDecorators": true, /* Enables experimental support for ES7 decorators. */ "emitDecoratorMetadata": true, /* Enables experimental support for emitting type metadata for decorators. */ /* Advanced Options */ "forceConsistentCasingInFileNames": true /* Disallow inconsistently-cased references to the same file. */ }, "compileOnSave": true, "files": ["./LInQer.extra.ts", "./LInQer.Slim.ts","./LInQer.Enumerable.ts","./LInQer.GroupEnumerable.ts","./LInQer.OrderedEnumerable.ts"] } ================================================ FILE: tsconfig.json ================================================ { "compilerOptions": { /* Basic Options */ // "incremental": true, /* Enable incremental compilation */ "target": "es6", /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */ "module": "system", /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */ // "lib": [], /* Specify library files to be included in the compilation. */ // "allowJs": true, /* Allow javascript files to be compiled. */ // "checkJs": true, /* Report errors in .js files. */ // "jsx": "preserve", /* Specify JSX code generation: 'preserve', 'react-native', or 'react'. */ // "declaration": true, /* Generates corresponding '.d.ts' file. */ // "declarationMap": true, /* Generates a sourcemap for each corresponding '.d.ts' file. */ // "sourceMap": true, /* Generates corresponding '.map' file. */ "outFile": "./LInQer.js", /* Concatenate and emit output to single file. */ // "outDir": "./", /* Redirect output structure to the directory. */ // "rootDir": "./", /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */ // "composite": true, /* Enable project compilation */ // "tsBuildInfoFile": "./", /* Specify file to store incremental compilation information */ // "removeComments": true, /* Do not emit comments to output. */ // "noEmit": true, /* Do not emit outputs. */ // "importHelpers": true, /* Import emit helpers from 'tslib'. */ // "downlevelIteration": true, /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */ // "isolatedModules": true, /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */ /* Strict Type-Checking Options */ "strict": true, /* Enable all strict type-checking options. */ "noImplicitAny": true, /* Raise error on expressions and declarations with an implied 'any' type. */ "strictNullChecks": true, /* Enable strict null checks. */ "strictFunctionTypes": true, /* Enable strict checking of function types. */ "strictBindCallApply": true, /* Enable strict 'bind', 'call', and 'apply' methods on functions. */ "strictPropertyInitialization": true, /* Enable strict checking of property initialization in classes. */ "noImplicitThis": true, /* Raise error on 'this' expressions with an implied 'any' type. */ "alwaysStrict": true, /* Parse in strict mode and emit "use strict" for each source file. */ /* Additional Checks */ // "noUnusedLocals": true, /* Report errors on unused locals. */ // "noUnusedParameters": true, /* Report errors on unused parameters. */ // "noImplicitReturns": true, /* Report error when not all code paths in function return a value. */ // "noFallthroughCasesInSwitch": true, /* Report errors for fallthrough cases in switch statement. */ /* Module Resolution Options */ // "moduleResolution": "node", /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */ // "baseUrl": "./", /* Base directory to resolve non-absolute module names. */ // "paths": {}, /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */ // "rootDirs": [], /* List of root folders whose combined content represents the structure of the project at runtime. */ // "typeRoots": [], /* List of folders to include type definitions from. */ // "types": [], /* Type declaration files to be included in compilation. */ // "allowSyntheticDefaultImports": true, /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */ "esModuleInterop": true, /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */ // "preserveSymlinks": true, /* Do not resolve the real path of symlinks. */ // "allowUmdGlobalAccess": true, /* Allow accessing UMD globals from modules. */ /* Source Map Options */ // "sourceRoot": "", /* Specify the location where debugger should locate TypeScript files instead of source locations. */ // "mapRoot": "", /* Specify the location where debugger should locate map files instead of generated locations. */ // "inlineSourceMap": true, /* Emit a single file with source maps instead of having a separate file. */ // "inlineSources": true, /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */ /* Experimental Options */ "experimentalDecorators": true, /* Enables experimental support for ES7 decorators. */ "emitDecoratorMetadata": true, /* Enables experimental support for emitting type metadata for decorators. */ /* Advanced Options */ "forceConsistentCasingInFileNames": true /* Disallow inconsistently-cased references to the same file. */ }, "compileOnSave": true, "files": ["./LInQer.Slim.ts","./LInQer.Enumerable.ts","./LInQer.GroupEnumerable.ts","./LInQer.OrderedEnumerable.ts","./npm.export.ts"] } ================================================ FILE: tsconfig.slim.json ================================================ { "compilerOptions": { /* Basic Options */ // "incremental": true, /* Enable incremental compilation */ "target": "es6", /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019' or 'ESNEXT'. */ "module": "system", /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */ // "lib": [], /* Specify library files to be included in the compilation. */ // "allowJs": true, /* Allow javascript files to be compiled. */ // "checkJs": true, /* Report errors in .js files. */ // "jsx": "preserve", /* Specify JSX code generation: 'preserve', 'react-native', or 'react'. */ // "declaration": true, /* Generates corresponding '.d.ts' file. */ // "declarationMap": true, /* Generates a sourcemap for each corresponding '.d.ts' file. */ // "sourceMap": true, /* Generates corresponding '.map' file. */ "outFile": "./LInQer.slim.js", /* Concatenate and emit output to single file. */ // "outDir": "./", /* Redirect output structure to the directory. */ // "rootDir": "./", /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */ // "composite": true, /* Enable project compilation */ // "tsBuildInfoFile": "./", /* Specify file to store incremental compilation information */ // "removeComments": true, /* Do not emit comments to output. */ // "noEmit": true, /* Do not emit outputs. */ // "importHelpers": true, /* Import emit helpers from 'tslib'. */ // "downlevelIteration": true, /* Provide full support for iterables in 'for-of', spread, and destructuring when targeting 'ES5' or 'ES3'. */ // "isolatedModules": true, /* Transpile each file as a separate module (similar to 'ts.transpileModule'). */ /* Strict Type-Checking Options */ "strict": true, /* Enable all strict type-checking options. */ "noImplicitAny": true, /* Raise error on expressions and declarations with an implied 'any' type. */ "strictNullChecks": true, /* Enable strict null checks. */ "strictFunctionTypes": true, /* Enable strict checking of function types. */ "strictBindCallApply": true, /* Enable strict 'bind', 'call', and 'apply' methods on functions. */ "strictPropertyInitialization": true, /* Enable strict checking of property initialization in classes. */ "noImplicitThis": true, /* Raise error on 'this' expressions with an implied 'any' type. */ "alwaysStrict": true, /* Parse in strict mode and emit "use strict" for each source file. */ /* Additional Checks */ // "noUnusedLocals": true, /* Report errors on unused locals. */ // "noUnusedParameters": true, /* Report errors on unused parameters. */ // "noImplicitReturns": true, /* Report error when not all code paths in function return a value. */ // "noFallthroughCasesInSwitch": true, /* Report errors for fallthrough cases in switch statement. */ /* Module Resolution Options */ // "moduleResolution": "node", /* Specify module resolution strategy: 'node' (Node.js) or 'classic' (TypeScript pre-1.6). */ // "baseUrl": "./", /* Base directory to resolve non-absolute module names. */ // "paths": {}, /* A series of entries which re-map imports to lookup locations relative to the 'baseUrl'. */ // "rootDirs": [], /* List of root folders whose combined content represents the structure of the project at runtime. */ // "typeRoots": [], /* List of folders to include type definitions from. */ // "types": [], /* Type declaration files to be included in compilation. */ // "allowSyntheticDefaultImports": true, /* Allow default imports from modules with no default export. This does not affect code emit, just typechecking. */ "esModuleInterop": true, /* Enables emit interoperability between CommonJS and ES Modules via creation of namespace objects for all imports. Implies 'allowSyntheticDefaultImports'. */ // "preserveSymlinks": true, /* Do not resolve the real path of symlinks. */ // "allowUmdGlobalAccess": true, /* Allow accessing UMD globals from modules. */ /* Source Map Options */ // "sourceRoot": "", /* Specify the location where debugger should locate TypeScript files instead of source locations. */ // "mapRoot": "", /* Specify the location where debugger should locate map files instead of generated locations. */ // "inlineSourceMap": true, /* Emit a single file with source maps instead of having a separate file. */ // "inlineSources": true, /* Emit the source alongside the sourcemaps within a single file; requires '--inlineSourceMap' or '--sourceMap' to be set. */ /* Experimental Options */ "experimentalDecorators": true, /* Enables experimental support for ES7 decorators. */ "emitDecoratorMetadata": true, /* Enables experimental support for emitting type metadata for decorators. */ /* Advanced Options */ "forceConsistentCasingInFileNames": true /* Disallow inconsistently-cased references to the same file. */ }, "compileOnSave": true, "files": ["./LInQer.Slim.ts"] }