# ask11-storage

> Functional wrapper around localForage

Latest version **0.5.0** (published 2014-07-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install ask11-storage
pnpm add ask11-storage
yarn add ask11-storage
bun add ask11-storage
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.5.0 |
| Published | 2014-07-10 |
| First published | 2014-05-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 598 |
| Author | Aleksey Kulikov |
| Maintainers | ask11 |
| Keywords | offline, storage, localForage, browserify |

## Links

- npm: https://www.npmjs.com/package/ask11-storage
- Repository: git@github.com:ask11/storage
- Homepage: https://github.com/ask11/storage
- Issues: https://github.com/ask11/storage/issues
- npm.io page: https://npm.io/package/ask11-storage

## Alternatives

- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads

## Recent versions

- 0.5.0 (latest) — 2014-07-10
- 0.4.1 — 2014-06-06
- 0.4.0 — 2014-06-06
- 0.2.0 — 2014-06-02
- 0.1.0 — 2014-05-26

## README

# Storage [![Build Status](https://travis-ci.org/alekseykulikov/storage.png?branch=master)](https://travis-ci.org/alekseykulikov/storage)

  Storage is a functional wrapper around [localForage](https://github.com/mozilla/localForage).
  That means it's an asynchronous browser storage with multiple back-ends (IndexedDB, WebSQL, localStorage),
  which is built for a better offline experience.

  The main differences with localForage:

  - batch get/set support
  - callbacks or promises
  - browserify friendly
  - simple API inspired by [yields/store](https://github.com/yields/store)
  - development mode

## Installation

```
$ npm install asyncstorage --save
$ bower install storage
$ component install alekseykulikov/storage
```

  Standalone build available as [./dist/storage.js](./dist/storage.js).

```html
<script src="storage.js"></script>
<script>window.storage('key', fn);</script>
```

## Example

```js
// set
storage({ key: 'val', key2: 'val2'}, function(err) {});

// get
storage('key', function(err, val) {});
storage(['key', 'key2'], function(err, all) {}); // all.length == 2

// count
storage(function(err, count) {}); // count == 2

// delete
storage('key', null, function(err) {});
storage(['key', 'key2'], null, function(err) {});
```

## API

  Each method returns promise, and accepts optional callback.

### storage([key, val, fn])

  Main function is facade to get/set/del/count methods. It's inspired by [yields/store](https://github.com/yields/store).
  Setting a key to `null` is equivalent to deleting the key via `storage.del(key)`.

### storage.get(key, [fn])

  Get `key` value.

### storage.get([key1, key2, ..., keyn], [fn])

  Get group of values. Callbacks return array of values for each key.
  If key does not exist, it returns `null` on this position.

### storage.set(key, val, [fn])

  Set `key` to `val`.
  You can store any kind of data, including [blobs](https://hacks.mozilla.org/2014/02/localforage-offline-storage-improved/).

### storage.set({ key1: val1, key2: val2, key3: val3 }, [fn])

  Run a batch operation.
  Simple way to create, update, remove multiple records.
  Use `null` to remove record.

```js
// assume we have 2 records
storage.set('foo', 7, fn)
storage.set('bar', ['one', 'two', 'three'], fn);

storage.set({
  baz: 'val' // create new val
  foo: 1000, // update `foo` value
  bar: null, // remove `bar`
}, function(err) {});
```

### storage.del(key, [fn])

  Delete `key`.

### storage.del([key1, key2, ..., keyn], [fn])

  Delete a group of keys in one request.

### storage.clear()

  Clear storage.

### storage.count()

  Count records.

### storage.development

  Work with async code console can be unpleasant.
  Setup development flag and storage will console.log() results of `get` or `count`.

```js
storage.development = true;
storage.set({ foo: 1, bar: 2 });
storage.get(['foo', 'bar']);
// => [1 ,2]
storage.del('bar');
storage.count();
// => 1
// shortcut to: storage.count().then(console.log.bind(console));
```

### storage.forage

  It gives you access to the localForage instance.
  You can use it to configure backend or for advanced methods as `keys` or `iterate`.

```js
storage.forage.config({ name: 'my-name' });
if (!window.indexedDB) storage.forage.setDriver(storage.forage.LOCALSTORAGE);

storage.forage.keys().then(function(keys) {
  console.log(keys);
});
```

---
_Source: https://npm.io/package/ask11-storage · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._