Collect.js

collect.js is a dependency-free JavaScript library that provides a fluent, chainable interface for manipulating arrays and objects. It mirrors the Laravel Collection API, offering a consistent set of methods for data transformation across JavaScript and Laravel backend environments. The library stores collection data as plain arrays internally and supports fluent method chaining, where each method returns a new collection instance.

The library distinguishes itself by closely replicating the Laravel Collection API in JavaScript, mapping each PHP method to an equivalent JavaScript implementation with identical signatures and behavior. It supports callback-based filtering and transformation, dot-notation for accessing nested values, and a prototype extension mechanism for registering custom methods. This allows developers working across JavaScript and Laravel backends to use a consistent, familiar API for data processing.

collect.js provides a comprehensive set of operations for data manipulation, including filtering, sorting, grouping, aggregation, pagination, and set operations. It also includes debugging utilities for inspecting collection state during development. The library is designed as a straightforward utility for chaining array and object operations with a clean, expressive syntax.

Features

Fluent Array Wrappers - Provides a fluent, chainable API for manipulating arrays and objects, mirroring Laravel Collections.

Laravel-Style Collection Constructors - Provides a JavaScript implementation of the Laravel collection API for fluent array manipulation.

First and Last Element Accessors - Retrieves the first element matching a condition, or the first element if no condition is given.

First Matching Item Retrievers with Defaults - Ships a method to retrieve the first matching item with a default fallback, a common collection operation.

Array Difference Computation - Ships a method to compute the set difference between collections, finding items present in one but not another.

JavaScript Collection Wrappers - Wraps arrays and objects in a fluent interface for readable method chains in JavaScript.

Collection Filtering - Filters collection elements using a callback function, returning only those that pass the test.

Collection Groupings - Organizes collection items into sub-collections keyed by a property or callback result.

Asynchronous Collection Iteration - Executes a callback for each item in a collection, enabling side effects without modifying the original data.

Collection Statistics - Computes aggregate statistics like sum, average, median, mode, min, and max from collections.

Collection Range Slicing - Ships a method to extract a subset of a collection by index and optional length, a standard slicing operation.

Collection Data Exposers - Provides a method to retrieve the underlying array or object from a collection, essential for interoperability.

Collection Size Counters - Returns the total number of items in a collection.

Fluent Chainable Toolkits - Provides a fluent toolkit for filtering, sorting, grouping, and aggregating data in arrays and objects.

Key-Based Collection Grouping - Groups collection items by a given key or callback, returning a new collection with group names as keys.

Key Retrievals - Retrieves values by key from collections, supporting default fallbacks for missing keys.

Key-Value Pair Assignments - Provides a method to set a value by key in a collection, a fundamental data manipulation operation.

Map Order Reversals - Provides a method to reverse the order of items in a collection, a fundamental array manipulation.

Key Listing - Returns all keys from a collection as a new collection for further manipulation.

Key Existence Verifiers - Determines whether one or more keys exist in a collection, returning true only when all specified keys are present.

List-to-Dictionary Mappings - Transforms collection items into dictionaries, groups, or key-value pairs using a callback.

Collection Sum Calculators - Ships a method to sum collection values, a core aggregation operation for data analysis.

Extraction Utilities - Provides a pluck method that extracts all values for a given key from a collection.

Combined Filtering and Transformation - Accepts user-defined callbacks for filtering, mapping, sorting, and reducing collection items.

Collection Item Existence Checks - Checks whether a collection contains a specific value, key-value pair, or items matching a condition.

Collection-to-JSON Converters - Provides a method to serialize collection data into JSON strings for storage or transmission.

Collection Key Removers - Ships a method to delete items by key from collections, a fundamental collection operation.

Collection Splice Operations - Provides a method to splice collections, removing and replacing items at a given index.

Collection Pagination Utilities - Splits a collection into pages of a given size and returns the items for a specific page number.

Collection Randomization Utilities - Returns one or more random items from the collection.

Fluent Method Chain Stubs - Returns a new collection instance from every method for sequential chaining without intermediates.

Return Values - Returns all values from a collection as a plain array for further processing.

Fluent Chainable Wrappers - Provides a dependency-free fluent interface for chaining array and object operations.

Laravel API Parity - Mirrors the Laravel Collection API in JavaScript for consistent data processing across environments.

Flat Sequence Mappers - Provides a flatMap operation that maps and flattens nested arrays into a single sequence.

Data Transformation Pipelines - Transforms data through method chains for filtering, mapping, sorting, and reducing collections.

API Surface Mirroring - Maps each PHP Laravel Collection method to an equivalent JavaScript implementation with identical signatures.

Array Intersection Algorithms - Returns items present in both the original and a given collection, performing set intersection.

Dot-Notation Value Retrievers - Retrieves values from nested arrays or objects using dot notation with optional default fallback.

Collection Shuffling - Ships a method to randomly reorder items in a collection, a standard array shuffling operation.

Duplicate Removal - Provides a method to remove duplicate values from collections, a core data manipulation operation.

Collection Item Transformers - Provides a method to transform each item in a collection via a callback, a fundamental map operation.

Collection Sorting Utilities - Ships methods to sort collections by value, key, or custom callback, a fundamental data manipulation capability.

Collection Splice Operations - Provides a method to splice collections, removing and replacing items at a given index.

Laravel Integrations - Provides a JavaScript API that mirrors Laravel Collections for cross-environment data processing.

Last Matching Element Retrievers - Ships a method to retrieve the last matching element from a collection, extending basic accessor functionality.

Collection Side-Effect Pipelines - Implements a tap method for injecting side effects into fluent collection chains without altering the data.

Collection Comparisons - Returns key-value pairs from the original collection whose keys are absent in another collection.

Collection Reducers - Provides a reduce method that iterates over items and accumulates them into a single result.

Column Value Aggregations - Calculates sum, average, median, mode, min, or max across all items or a specified key.

Grouped Counts - Ships a method to count items grouped by a specified key or callback function.

Collection Merging - Implements a merge method that combines collections, overwriting matching keys or appending values.

Unique Value Collections - Provides a unique method that removes duplicate values from collections.

Deduplication by Key - Implements a unique method that deduplicates collections by value or by a specified key.

Flattening - Reduces nested arrays or objects into a single-level collection, optionally to a given depth.

Key-Based Subset Extractors - Returns only items with specified keys or indices, or excludes items by key.

Collection Size Checkers - Provides a method to check if a collection contains exactly one item, useful for validation logic.

First Matching Item Retrievers with Error Handling - Implements a first-or-fail retrieval pattern for collections, useful for strict data validation.

Emptiness Checks - Provides a method to check whether a collection contains no items.

Key Intersections - Filters a collection to keep only items whose keys exist in another collection.

Key-Value Pair Comparisons - Returns items from one collection whose key-value pairs are missing in another collection.

Maximum Value Calculators - Provides a method to find the largest value in a collection or from a given key.

Mode Value Calculators - Provides a method to calculate the mode of a collection's values.

Nested List Flattening - Recursively reduces a multi-dimensional array or object into a single-level collection.

Pagination - Provides a paginate method that returns items for a specific page number given a page size.

Value Joiners - Joins collection values into a string with a configurable separator.

Universal Condition Checks - Ships an every method that returns true only when all collection items pass a truth test.

Unique Value Counting - Provides a method to tally how many times each value appears in a collection.

Collection Element Removers - Removes an element from the collection using its key and returns the updated collection.

Collection Key Extractors - Returns an array of all keys present in the collection.

Minimum Value Finders - Provides a method to find the smallest value in a collection or from a given key.

Array Flattening Utilities - Collapses a collection of arrays into a single flat collection, removing one level of nesting.

Collection-to-Object Converters - Combines keys from one collection with values from another to produce a new object.

Key Filtering - Removes specified keys from a collection and returns the remaining items.

Array Element Finding - Returns the first element in a collection that matches a specified key-value pair.

Union Operations - Ships a union method that merges collections by adding only absent items.

Arithmetic Mean Calculators - Computes the arithmetic mean of collection items, optionally extracting values via a key or callback.

Median Calculators - Ships a median calculation method that returns the middle value of a collection.

Collection Difference Calculations - Compares two collections via a callback, returning items from the first not present in the second.

Custom Method Registration - Registers user-defined functions as fluent methods on the collection instance.

Duplicate Element Detection - Finds and returns all values that appear more than once in a collection.

Strict Equality Assertions - Uses strict equality by default for collection comparisons, eliminating the need for separate strict methods.

Membership Absence Checks - Provides a doesNotContain method that checks for the absence of a value in a collection.

Prototype Extensions - Registers custom methods on the collection prototype for reuse across all instances.

String Joining - Joins collection items into a single string with optional separator and final separator before the last element.

Collection Partitioning & Grouping - Provides a partition method that splits items into two groups based on a truth test.

Dot Notation Field Accessors - Retrieves nested values from arrays and objects using dot-separated key paths with defaults.

ecrmnncollect.js

Features

Star history