CookieDB

A database layer for the browser. CookieDB is for creating structured data in the form of documents and collections using client-side javascript.

View the Project on GitHub

Cookie:cookie:DB

CookieDB is a database for the browser. It can store data as documents in collections like any noSQL database. It allows for very organized and structured data by using nothing other than javascript on the browser.

Setup

Simply include the cookiedb.js file into your project and link to it through script tags.

<script src="cookiedb.js"></script>

In your javascript file, create a new cookiedb database.

const db = new CookieDB()

Now, you can organize your data into collections and insert, update, find, and remove that data from your web application.

Documentation

Create Collection

CookieDB, much like all noSQL databases stores your data into collections for better organization. To begin using the features of CookieDB create a collection.

db.createCollection('books')

Insert

Store an object on the browser in a collection. This information will be available even after the user has closed their tab or browser. Call the insert function on the CookieDB object and pass the collection in which you want to store data, followed by object that you want to store. Let’s populate our database books collection with books

db.insert('books', { title: 'The Great Gatsby', year: 1925, author: 'F. Scott Fitzgerald' })
db.insert('books', { title: 'Nineteen Eighty-Four', year: 1949, author: 'George Orwell' })
db.insert('books', { title: 'To Kill a Mockingbird', year: 1960, author: 'Harper Lee' })
db.insert('books', { title: 'Animal Farm', year: 1945, author: 'George Orwell' })

Update

Update a value that is pre-existing in the database, by passing the collection, the _id, and the values you want to update in the old value. The _id is just the unique identifier that represents the order in which the items were inserted. Let’s update the two George Orwell books to reflect the authors real name which is Eric Blair. A multiple-update feature will be added soon.

/* Since we know the _id's of the George Orwell books
   are 1 and 3 we can update them directly. If you don't 
   know the _id's simply query for the object you are 
   looking for and obtain the _id. */
db.update('books', 1, { author: 'Eric Blair' })
db.update('books', 3, { author: 'Eric Blair' })

Find

Find the value of the data you are looking for in a collection by referencing a subset of its properties, passing an empty object will return all documents in the specified collection. The find function returns an array of all items in the database that match the query. The function can return an empty array or array of length 1. Let’s query for The Great Gatsby book.

db.find('books' { title: 'The Great Gatsby' })
// returns [{_id: 0, title: 'The Great Gatsby', year: 1925, author: 'F. Scott Fitzgerald'}]

Remove

Remove some value(s) that exists in the database by a subset of its properties. Let’s remove all books published in 1960.

db.remove('books', { year: 1960 })
// removes to kill a mockingbird from the database

Count

Returns the number of items that are in the database. Since we have 4 books in our database, it will return 4.

db.count()
// returns 4

Drop

Deletes all the content of the database.

db.drop()

Features

Todo