Question 1

How does List compare to Immutable.js for functional programming?

Accepted Answer

List focuses solely on lists with a Ramda-compatible API, offering better tree-shaking and performance for sequence operations, while Immutable.js provides multiple data structures but with a larger bundle size. List's benchmarks show it often outperforms in functional transformations, but Immutable.js might be better for diverse collection needs.

Question 2

How to update an element at a specific index in List?

Accepted Answer

Use the `update` or `adjust` functions, which take an index and return a new list—for example, `update(2, 'X', list('a', 'b', 'c'))` replaces the third element. This is O(log(n)) and immutable, unlike native array's mutable assignment.

Question 3

Does List work with React state management like Redux?

Accepted Answer

Yes, List is ideal for Redux or React state where immutability is key, as it ensures safe updates without mutations. You can store lists in state and use functions like `map` or `filter` to create new states, but remember to convert to arrays if UI libraries expect them.

Question 4

What's the bundle size impact of adding List to a project?

Accepted Answer

List is tree-shaking friendly, with core under 1KB and functions added only as used—importing the whole library adds about 10KB gzipped. For small projects, native arrays might be lighter, but for functional-heavy code, the performance gains can justify the size.

Question 5

How to handle side-effects like logging with List?

Accepted Answer

Use the `forEach` function for side-effects, as it's optimized for this purpose without constructing a new list. The README warns against overusing `for..of` loops, which are slower and less idiomatic in functional contexts.

Question 6

Can List sort objects by a property efficiently?

Accepted Answer

Yes, use `sortBy` with a function that extracts the property—it performs a stable sort in O(n*log(n)) time. For example, `sortBy(o => o.n, list({n:3}, {n:1}))` returns a sorted list, similar to Ramda but with List's immutable performance.

List

What is List?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions