seamless-immutable

What is seamless-immutable?

The seamless-immutable npm package provides a way to create and work with deeply immutable data structures in JavaScript. It ensures that objects and arrays cannot be modified after they are created, which helps in maintaining predictable state and avoiding side effects in applications.

What are seamless-immutable's main functionalities?

Creating Immutable Objects

This feature allows you to create immutable objects. Once created, the object cannot be modified.

const Immutable = require('seamless-immutable');
const obj = Immutable({ name: 'John', age: 30 });
console.log(obj); // Output: { name: 'John', age: 30 }

Creating Immutable Arrays

This feature allows you to create immutable arrays. Once created, the array cannot be modified.

const Immutable = require('seamless-immutable');
const arr = Immutable([1, 2, 3]);
console.log(arr); // Output: [1, 2, 3]

Merging Immutable Objects

This feature allows you to merge immutable objects, creating a new immutable object with the merged properties.

const Immutable = require('seamless-immutable');
const obj1 = Immutable({ name: 'John', age: 30 });
const obj2 = obj1.merge({ age: 31 });
console.log(obj2); // Output: { name: 'John', age: 31 }

Updating Immutable Arrays

This feature allows you to perform operations on immutable arrays, resulting in a new immutable array.

const Immutable = require('seamless-immutable');
const arr = Immutable([1, 2, 3]);
const newArr = arr.map(x => x * 2);
console.log(newArr); // Output: [2, 4, 6]

Other packages similar to seamless-immutable

immutable

The 'immutable' package provides persistent immutable data structures including List, Stack, Map, OrderedMap, Set, and OrderedSet. It offers more complex data structures and methods compared to seamless-immutable, but can be more complex to use.

immer

The 'immer' package allows you to work with immutable state by using a 'draft' state that you can modify directly. It then produces the next immutable state based on the changes. It is simpler to use for complex state updates compared to seamless-immutable.

mori

The 'mori' package provides a set of Clojure-inspired immutable data structures and functions for JavaScript. It is more functional programming-oriented and offers a different approach compared to seamless-immutable.

README

seamless-immutable

Immutable data structures for JavaScript which are backwards compatible with normal JS Arrays and Objects.