Upgrade Guide

This document describes breaking changes and how to upgrade. For a complete list of changes including minor and patch releases, please refer to the CHANGELOG.

v4

This is an upgrade to abstract-leveldown@6 which solves long-standing issues around serialization and type support.

Range options are now serialized

Previously, range options like lt were passed through as-is by abstract-leveldown, unlike keys. This makes no difference for memdown as it does not serialize anything.

The rules for range options have been relaxed

Because null, undefined, zero-length strings and zero-length buffers are significant types in encodings like bytewise and charwise, they became valid as range options in abstract-leveldown. This means db.iterator({ gt: undefined }) is not the same as db.iterator({}).

For memdown, when used by itself, the behavior of null, undefined, zero-length strings and zero-length buffers is undefined.

Nullish values are rejected

In addition to rejecting null and undefined as keys, abstract-leveldown now also rejects these types as values, due to preexisting significance in streams and iterators.

Zero-length array keys are rejected

Though this was already the case, abstract-leveldown has replaced the behavior with an explicit Array.isArray() check and a new error message.

Browser support

IE10 has been dropped.

v3

Dropped support for node 4. No other breaking changes.

v2

This release drops Node.js 0.12, brings memdown up to par with latest levelup (v2) and abstract-leveldown (v4), simplifies serialization and removes global state.

Targets latest levelup

Usage has changed to:

const levelup = require('levelup')
const memdown = require('memdown')

const db = levelup(memdown())

From the old:

const db = levelup('mydb', { db: memdown })

No stringification of keys and values

This means that in addition to Buffers, you can store any JS type without the need for encoding-down. This release also makes behavior consistent in Node.js and browsers. Please refer to the README for a detailed explanation.

No global state or location argument

If you previously did this to make a global store:

const db = levelup('mydb', { db: memdown })

You must now attach the store to a global yourself (if you desire global state):

const db = window.mydb = levelup(memdown())

No null batch operations

Instead of skipping null operations, db.batch([null]) will throw an error courtesy of abstract-leveldown.