leebyron

immutable

  "description": "Immutable Data Collections",

  "homepage": "https://immutable-js.com",

    "url": "git://github.com/immutable-js/immutable-js.git"

    "url": "https://github.com/immutable-js/immutable-js/issues"

[![Build Status](https://github.com/immutable-js/immutable-js/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/immutable-js/immutable-js/actions/workflows/ci.yml?query=branch%3Amain) [Chat on slack](https://immutable-js.slack.com)

[Read the docs](https://immutable-js.com) and eat your vegetables.

[Read the docs](https://immutable-js.com/docs/) and eat your vegetables.

Docs are automatically generated from [README.md][] and [immutable.d.ts][].

Please contribute! Also, don't miss the [wiki][] which contains articles on

additional specific topics. Can't find something? Open an [issue][].

- [The case for Immutability](#the-case-for-immutability)

- [JavaScript-first API](#javascript-first-api)

- [Nested Structures](#nested-structures)

- [Equality treats Collections as Values](#equality-treats-collections-as-values)

- [Batching Mutations](#batching-mutations)

- [Additional Tools and Resources](#additional-tools-and-resources)

[Immutable][] data cannot be changed once created, leading to much simpler

application development, no defensive copying, and enabling advanced memoization

and change detection techniques with simple logic. [Persistent][] data presents

a mutative API which does not update the data in-place, but instead always

Immutable.js provides many Persistent Immutable data structures including:

`List`, `Stack`, `Map`, `OrderedMap`, `Set`, `OrderedSet` and `Record`.

These data structures are highly efficient on modern JavaScript VMs by using

structural sharing via [hash maps tries][] and [vector tries][] as popularized

by Clojure and Scala, minimizing the need to copy or cache data.

Immutable.js also provides a lazy `Seq`, allowing efficient

chaining of collection methods like `map` and `filter` without creating

intermediate representations. Create some `Seq` with `Range` and `Repeat`.

Want to hear more? Watch the presentation about Immutable.js:

[![Immutable Data and React](website/public/Immutable-Data-and-React-YouTube.png)](https://youtu.be/I7IdS-PbEgI)

[README.md]: https://github.com/immutable-js/immutable-js/blob/main/README.md

[immutable.d.ts]: https://github.com/immutable-js/immutable-js/blob/main/type-definitions/immutable.d.ts

[wiki]: https://github.com/immutable-js/immutable-js/wiki

[issue]: https://github.com/immutable-js/immutable-js/issues

[Persistent]: https://en.wikipedia.org/wiki/Persistent_data_structure

[Immutable]: https://en.wikipedia.org/wiki/Immutable_object

[hash maps tries]: https://en.wikipedia.org/wiki/Hash_array_mapped_trie

[vector tries]: https://hypirion.com/musings/understanding-persistent-vector-pt-1

map1.get('b') + ' vs. ' + map2.get('b'); // 2 vs. 50

Immutable.js has no dependencies, which makes it predictable to include in a Browser.

It's highly recommended to use a module bundler like [webpack](https://webpack.github.io/),

[browserify](https://browserify.org/). The `immutable` npm module works

without any additional consideration. All examples throughout the documentation

Alternatively, Immutable.js may be directly included as a script tag. Download

or link to a CDN such as [CDNJS](https://cdnjs.com/libraries/immutable)

or [jsDelivr](https://www.jsdelivr.com/package/npm/immutable).

Use a script tag to directly add `Immutable` to the global scope:

  var map1 = Immutable.Map({ a: 1, b: 2, c: 3 });

		{
		"name": "immutable",
		"version": "4.3.4",
		"version": "4.3.5",
		"description": "Immutable Data Collections",
		@@ -5,0 +5,0 @@ "license": "MIT",

		@@ -5,3 +5,3 @@ # Immutable collections for JavaScript

		[Read the docs](https://immutable-js.com) and eat your vegetables.
		[Read the docs](https://immutable-js.com/docs/) and eat your vegetables.

		@@ -8,0 +8,0 @@ Docs are automatically generated from [README.md][] and [immutable.d.ts][].

Improved metrics