前端项目-collect.js.zip

# <img src="https://raw.githubusercontent.com/ecrmnn/collect.js/master/collectjs.jpg" alt="collect.js"> > Convenient and dependency free wrapper for working with arrays and objects [](https://travis-ci.org/ecrmnn/collect.js/builds) [](http://badge.fury.io/js/collect.js) [](http://badge.fury.io/js/collect.js) [](http://badge.fury.io/js/collect.js) [](http://makeapullrequest.com) [](https://github.com/ecrmnn/collect.js/blob/master/package.json) [](https://github.com/airbnb/javascript) [](https://cdnjs.com/libraries/collect.js) ### Installation #### NPM ```bash npm install collect.js --save ``` #### Yarn ```bash yarn add collect.js ``` #### From CDN 1. Visit https://cdnjs.com/libraries/collect.js 2. Add CDN link to your site with `<script>` #### Using build / minified version 1. Download [`collect.min.js`](https://github.com/ecrmnn/collect.js/blob/master/build/collect.min.js) 2. Add to your site with `<script>` ### Tip Using Laravel as your backend? Collect.js offers an (almost) identical api to [Laravel Collections](https://laravel.com/docs/master/collections). [See differences](#strictness-and-comparisons). ### Usage All available methods - [all](#all) - [average](#average) - [chunk](#chunk) - [collapse](#collapse) - [combine](#combine) - [concat](#concat) - [contains](#contains) - [count](#count) - [countBy](#countby) - [crossJoin](#crossjoin) - [dd](#dd) - [diff](#diff) - [diffAssoc](#diffassoc) - [diffKeys](#diffkeys) - [dump](#dump) - [duplicates](#duplicates) - [each](#each) - [eachSpread](#eachspread) - [every](#every) - [except](#except) - [filter](#filter) - [first](#first) - [firstWhere](#firstwhere) - [flatMap](#flatmap) - [flatten](#flatten) - [flip](#flip) - [forget](#forget) - [forPage](#forpage) - [get](#get) - [groupBy](#groupby) - [has](#has) - [implode](#implode) - [intersect](#intersect) - [intersectByKeys](#intersectbykeys) - [isEmpty](#isempty) - [isNotEmpty](#isnotempty) - [join](#join) - [keyBy](#keyby) - [keys](#keys) - [last](#last) - [macro](#macro) - [make](#make) - [map](#map) - [mapInto](#mapinto) - [mapSpread](#mapspread) - [mapToDictionary](#maptodictionary) - [mapToGroups](#maptogroups) - [mapWithKeys](#mapwithkeys) - [max](#max) - [median](#median) - [merge](#merge) - [mergeRecursive](#mergerecursive) - [min](#min) - [mode](#mode) - [nth](#nth) - [only](#only) - [pad](#pad) - [partition](#partition) - [pipe](#pipe) - [pluck](#pluck) - [pop](#pop) - [prepend](#prepend) - [pull](#pull) - [push](#push) - [put](#put) - [random](#random) - [reduce](#reduce) - [reject](#reject) - [replace](#replace) - [replaceRecursive](#replaceecursive) - [reverse](#reverse) - [search](#search) - [shift](#shift) - [shuffle](#shuffle) - [slice](#slice) - [some](#some) - [sort](#sort) - [sortBy](#sortby) - [sortByDesc](#sortbydesc) - [sortKeys](#sortkeys) - [splice](#splice) - [split](#split) - [sum](#sum) - [take](#take) - [tap](#tap) - [times](#times) - [toArray](#toarray) - [toJson](#tojson) - [transform](#transform) - [union](#union) - [unique](#unique) - [unless](#unless) - [unlessEmpty](#unlessEmpty) - [unlessNotEmpty](#unlessNotEmpty) - [unwrap](#unwrap) - [values](#values) - [when](#when) - [whenEmpty](#whenEmpty) - [whenNotEmpty](#whenNotEmpty) - [where](#where) - [whereBetween](#wherebetween) - [whereIn](#wherein) - [whereInstanceOf](#whereinstanceof) - [whereNotBetween](#wherenotbetween) - [whereNotIn](#wherenotin) - [wrap](#wrap) - [zip](#zip) ### Strictness and comparisons All comparisons in `collect.js` are done using strict equality. Using loose equality comparisons are generally frowned upon in JavaScript. Laravel only performs "loose" comparisons by default and offer several "strict" comparison methods. These methods have not been implemented in `collect.js` because all methods are strict by default. ##### Methods that have not been implemented: - ~~`containsStrict`~~ use `contains()` - ~~`duplicatesStrict`~~ use `duplicates()` - ~~`uniqueStrict`~~ use `unique()` - ~~`whereStrict`~~ use `where()` - ~~`whereInStrict`~~ use `whereIn()` - ~~`whereNotInStrict`~~ use `whereNotIn()` #### `all()` The all method returns the underlying array represented by the collection: ```js collect([1, 2, 3]).all(); // [1, 2, 3] ``` #### `average()` Alias for the [`avg()`](#avg) method #### `avg()` The avg method returns the average of all items in the collection: ```js collect([1, 3, 3, 7]).avg(); // 3.5 ``` If the collection contains nested arrays or objects, you should pass a key to use for determining which values to calculate the average: ```js const collection = collect([ { name: 'My story', pages: 176, }, { name: 'Fantastic Beasts and Where to Find Them', pages: 1096, }, ]); collection.avg('pages'); // 636 ``` #### `chunk()` The chunk method breaks the collection into multiple, smaller collections of a given size: ```js const collection = collect([1, 2, 3, 4, 5, 6, 7]); const chunks = collection.chunk(4); chunks.all(); // [[1, 2, 3, 4], [5, 6, 7]] ``` #### `collapse()` The collapse method collapses a collection of arrays into a single, flat collection: ```js const collection = collect([[1], [{}, 5, {}], ['xoxo']]); const collapsed = collection.collapse(); collapsed.all(); // [1, {}, 5, {}, 'xoxo'] ``` ```js const collection = collect([[1, 2, 3], [4, 5, 6], [7, 8, 9]]); const collapsed = collection.collapse(); collapsed.all(); // [1, 2, 3, 4, 5, 6, 7, 8, 9] ``` #### `combine()` The combine method combines the keys of the collection with the values of another array or collection: ```js const collection = collect(['name', 'number']); const combine = collection.combine(['Steven Gerrard', 8]); combine.all(); // { // name: 'Steven Gerrard', // number: 8 // } ``` #### `concat()` The concat method is used to merge two or more collections/arrays/objects: _You can also `concat()` an array of objects, or a multidimensional array_ ```js const collection = collect([1, 2, 3]); let concatenated = collection.concat(['a', 'b', 'c']); concatenated = concatenated.concat({ name: 'Steven Gerrard', number: 8, }); concatenated.all(); // [1, 2, 3, 'a', 'b', 'c', 'Steven Gerrard', 8] ``` #### `contains()` The contains method determines whether the collection contains a given item: ```js const collection = collect({ name: 'Steven Gerrard', number: 8, }); collection.contains('name'); // true collection.contains('age'); // false collection.contains('Steven Gerrard'); // true ``` You may also work with arrays ```js const collection = collect([1, 2, 3]); collection.contains(3); // true ``` You may also pass a key / value pair to the contains method, which will determine if the given pair exists in the collection: ```js const collection = collect({ name: 'Steven Gerrard', number: 8, }); collection.contains('name', 'Steve Jobs'); // false ``` Finally, you may also pass a callback to the contains method to perform your own truth test: ```js const collection = collect([1, 2, 3, 4, 5]); collection.contains((value, key) => value > 5); // false ``` #### `count()` The count method returns the total number of items in the collection: ```js const collection = collect([1, 2, 3, 4]); collection.count(); // 4 ``` #### `countBy()` The countBy method counts the occurences of values in the collection.