You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

pouchdb-adapter-indexeddb

Package Overview
Dependencies
6
Maintainers
0
Versions
8
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

pouchdb-adapter-indexeddb

PouchDB adapter using IndexedDB as its data store.


Version published
Maintainers
0
Created

Readme

Source

pouchdb-adapter-indexeddb

PouchDB adapter using IndexedDB as its data store. Designed to run in the browser. Its adapter name is 'indexeddb'.

Usage

npm install pouchdb-adapter-indexeddb
PouchDB.plugin(require('pouchdb-adapter-indexeddb'));
var db = new PouchDB('mydb', {adapter: 'indexeddb'});

For full API documentation and guides on PouchDB, see PouchDB.com. For details on PouchDB sub-packages, see the Custom Builds documentation.

Source

PouchDB and its sub-packages are distributed as a monorepo.

For a full list of packages, see the GitHub source.

Differences between CouchDB and PouchDB's find implementations under IndexedDb

These should be merged into some part of the external PouchDB documentation when this becomes a publicly usable adapter, if it's the default adapter or if it's one you can mix in manually.

PouchDB attempts to be 100% compatible with CouchDB. However, there are some subtle differences you should be aware of between CouchDB and PouchDB running on IndexedDB.

First, note that these differences only exist in the native indexeddb index implementation. You can run an explain query to determine which index you're using. TODO: example.

Data type ordering

In upper bounded ranged queries (e.g, {foo: {$lt: 10}}) the returned order of null, true and false alongside very small integers (Number.MIN_SAFE_INTEGER + 2 and below) may be inconsistent with CouchDB's ordering.

This may be fixed in the future. See:

Object indexing in Mango

CouchDB supports null, booleans, numbers, strings, arrays and objects in its indexes, and ranged queries operate in that order.

Unfortunately IndexedDB does not support objects in indexes. If an object is present on indexed keypath that document will not be present in the index.

This will manifest in two ways:

  • If you are trying to use an object as a key to an index you will not get the correct results
  • If you are doing a lower bounded ranged query (eg. {foo: {$gt: 10}}) objects on this keypath (here foo) will not return their documents.

This is highly unlikely to be fixed in the future by PouchDB, as it would require improvements to IndexedDB. See:

Mango Queries with partial_filter_selector

Mango indexes with a partial_filter_selector are using map-reduce views. All performance gains of native IndexedDB indexes will be lost.

Also ordering is CouchDB compatible.

This fallback is required because IndexedDB indexes only work on all db entries. And not on a subsection.

FAQs

Package last updated on 21 Jun 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc