Core Concepts¶

Learn the fundamental concepts behind @arcaelas/collection.

Collections as Enhanced Arrays¶

Collections extend native JavaScript arrays with powerful methods:

const collection = new Collection([1, 2, 3]);
// Has all Array methods plus Collection methods

Use TypeScript generics for type-safe collections:

interface User {
  id: number;
  name: string;
}

const users = new Collection<User>([...]);

Collections support MongoDB-style queries:

collection.filter({
  age: { $gte: 18 },
  status: { $in: ['active', 'pending'] }
});

Most methods return new collections:

const original = new Collection([1, 2, 3]);
const filtered = original.filter(n => n > 1);
// original unchanged

Chain methods for fluent syntax:

collection
  .filter({ active: true })
  .sort('age', 'desc')
  .slice(0, 10);