Skip to content

Latest commit

 

History

History
101 lines (67 loc) · 2.47 KB

UPGRADING.md

File metadata and controls

101 lines (67 loc) · 2.47 KB
Raw

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.

4.0.0

Drops support of Node.js 10, upgrades to readable-stream@4 (082b8d6) and uses classes which means new is now required. If you previously did:

const WriteStream = require('level-ws')
const ws = WriteStream(db)

You must now do:

const WriteStream = require('level-ws')
const ws = new WriteStream(db)

3.0.0

This release drops support of legacy runtime environments (Level/community#98):

  • Node.js 6 and 8
  • Internet Explorer 11
  • Safari 9-11
  • Stock Android browser (AOSP).

2.0.0

Dropped node 9 and upgraded to readable-stream@3.

1.0.0

Dropped support for node 0.10, 0.12, 2, 3, 4 and 5.

The API only exports a single function and no longer patches levelup.

So if you previously did:

var ws = require('level-ws')
var db = ws(level('DB'))
var stream = db.createWriteStream()

You should now do:

var WriteStream = require('level-ws')
var db = level('DB')
var stream = WriteStream(db)

The parameters to the stream constructor were flipped.

So if you previously did:

var WriteStream = require('level-ws').WriteStream
var db = level('DB')
var stream = WriteStream({ type: 'del' }, db)

You should now do:

var WriteStream = require('level-ws')
var db = level('DB')
var stream = WriteStream(db, { type: 'del' })

The behavior of maxBufferLength was changed. Previously all write operations exceeding maxBufferLength in the same tick were dropped. Instead the stream is now paused until a batch has been flushed and unpaused once the batch has been completed.

WriteStream#destroySoon() was removed.

Internally this.writable and this.readable were removed. However, this.writable still exists due to inheritance, but this.readable is now undefined.

Default 'utf8' encoding was removed and also per stream encodings. However, it's still possible to specify encodings for individual entries. This means if you previously relied on per stream encodings, you must specify this in calls to .write():

writeStream.write({
  key: new Buffer([1, 2, 3]),
  value: { some: 'json' },
  keyEncoding: 'binary',
  valueEncoding : 'json'
})