isabella232 / js-datastore-level

Datastore implementation with level(up/down) backend

js-datastore-level

Datastore implementation with levelup backend.

Lead Maintainer

Alex Potsides

Table of Contents

• js-datastore-level
  • Lead Maintainer
  • Table of Contents
  • Install
  • Usage
    • Browser Shimming Leveldown
    • Database names
  • Contribute
  • License

Install

$ npm install datastore-level

The type definitions for this package are available on http://definitelytyped.org/. To install just use:

$ npm install -D @types/datastore-level

Usage

const LevelStore = require('datastore-level')

// Default using level as backend for node or the browser
const store = new LevelStore('path/to/store')

// another leveldown compliant backend like memdown
const memStore = new LevelStore('my/mem/store', {
  db: require('level-mem')
})

Browser Shimming Leveldown

LevelStore uses the level module to automatically use level.js if a modern bundler is used which can detect bundle targets based on the pkg.browser property in your package.json.

If you are using a bundler that does not support pkg.browser, you will need to handle the shimming yourself, as was the case with versions of LevelStore 0.7.0 and earlier.

Database names

level-js@3 changed the database prefix from IDBWrapper- to level-js-, so please specify the old prefix if you wish to continue using databases created using datastore-level prior to v0.12.0. E.g.

const leveljs = require('level-js')
const browserStore = new LevelStore('my/db/name', {
  db: (path) => leveljs(path, {
    prefix: 'IDBWrapper-'
  })
})

More information: https://github.com/Level/level-js/blob/master/UPGRADING.md#new-database-prefix

Contribute

Feel free to join in. All welcome. Open an issue!

This repository falls under the IPFS Code of Conduct.

License

MIT