histore - GitLite

KO | EN

gitlite — search

#javascript #react #llm #golang #android #rust #deep-learning #java #windows #awesome-list #pytorch #openai #mcp #open-source

histore

(★ 673)

🏬 200b key-value store backed by navigation state

File Explorer

Download Latest Version (.zip)

.gitignore
CONTRIBUTING.md
histore.js
LICENSE
package.json
README.md

# Installation Guide

1. Get the code

git clone https://github.com/developit/histore

Downloads the entire project code from GitHub to your computer.

cd histore

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

<a href="https://www.npmjs.org/package/histore"><img src="https://img.shields.io/npm/v/histore.svg?style=flat" alt="npm"></a>

Type this command into your terminal and run it.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="https://i.imgur.com/zN9xe7D.png" width="300" height="300" alt="histore">
  <h1 align="center">
  	Histore
	<a href="https://www.npmjs.org/package/histore"><img src="https://img.shields.io/npm/v/histore.svg?style=flat" alt="npm"></a>
  </h1>
</p>

Histore __[his·to·ry]__: a 200b key-value store backed by navigation state.

Does the fact that `sessionStorage`/`localStorage` is shared across tabs have you down?

Don't worry, here's a strange but widely supported way to store 640kb of object data in a page's navigation state.

[View Demo on JSFiddle](https://jsfiddle.net/developit/8Ltn29a5/)

## Usage

```js
import histore from 'histore'

let storage = histore()

storage.set('foo', 'bar')
storage.get('foo')  // 'bar'

storage.set('obj', { any: 'object' })
storage.get('obj').any  // 'object'
```

Interestingly, due to the way `history.replaceState` works, storing objects will implicitly clone them using the [Structured Clone algorithm](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm).

## Contributing

Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.

## Changelog

Every release, along with the migration instructions, is documented on the Github [Releases](https://github.com/developit/histore/releases) page.

## License

[Apache 2.0](LICENSE)