Deprecations
We have outright removed some undocumented APIs, and added warnings for some (formerly) documented APIs. Please read carefully in case you are using any of these features.
Deprecation 1: PouchDB.utils, PouchDB.ajax, PouchDB.Errors
We have removed the PouchDB.utils, PouchDB.ajax, and PouchDB.Errors APIs. These were always
undocumented and unsupported, and we regret if anybody accidentally ended up relying on them.
If you are using these APIs, please switch to the Custom Builds API instead.
Deprecation 2: db.put(doc, id, rev)
db.put({}, 'myid', '2-xxx');Instead of doing this, please put the _id and _rev on the document itself:
db.put({_id: 'myid', _rev: '2-xxx'});This API was not removed, but will log a warning if you try to use it.
Deprecation 3: new PouchDB(dbName, callback)
var db = new PouchDB('mydb', function (err) {
// called when PouchDB has asynchronously finished setting up
// (or has errored)
});Instead of using this format (which has been undocumented and unrecommended for
some time), please do:
var db = new PouchDB('mydb');
db.info().then(function () {
// db is now ready
}).catch(/* ... */;There is no need to "wait" for the PouchDB constructor to asynchronously finish
setting up, since the constructor has been made stateless. However, if you really
want to verify that the database is ready and working, you can do an info() request.
This API was not removed, but will log a warning if you try to use it.
New features
Bugfixes
- (#3539) - Ensure throw in user code does not effect pouch
- (#5272) - Fix checkpointing against Cloudant/CouchDB 2.0
- (#5225) - Guard uses of console before calling it
- (#5238) - Fix unhandled rejection in changes
- (#3923) - Add ability to set url as prefix
- (#4922) - Do not call 'destroyed' twice for http instances
- (#3609) - opts.view implies filter=_view
- (#4444) - Dont leak event emitters
- (#5197) - detect WebSQL invalid on WKWebView
- (#5200) - Don't clone special objects like Workers
- (#5196) - fix excessively long replication loop
- (#5157) - avoid launching more requests than browser can perform
- (#5140) - remove use of buffer.toArrayBuffer()
- (#5118) - Revert "(#4867) - Cache ddoc views and filters"
- (#2674) - avoid unneeded attachment GET requests
Deprecations
- (#5251) - Add deprecation notice for async constructor
- (#5154) - Add deprecation notice for db.put(doc, id, rev)
Documentation
- (#5094) - Remove editable title from home page
- (#5089) - Fix the install jekyll script
- (#4199) - add a download specific page
- (#5084) - Use bundler to install jekyll dependencies
- (#5083) - Saving of 12kb in payload if site css is minified
- (#5080) - Fix docs replication batch_size
- (#5082) - Remove references to iriscouch (#5234)
- (#4493) - Mention implication of views on size param (#5241)
- (#5080) - Clarify batch_size documentation
- (#4573) - Remove outdated Firefox Inspector link