lodash-id

lodash-id makes it easy to manipulate id-based resources with lodash or lowdb

• getById
• insert
• upsert
• updateById
• updateWhere
• replaceById
• removeById
• removeWhere
• createId

Install

1# with lodash
2npm install lodash lodash-id --save
3
4# with lowdb
5npm install lowdb lodash-id --save

Note lodash-id is also compatible with underscore

API

In the API examples, we're assuming db to be:

1const db = {
2  posts: [
3    {id: 1, body: 'one', published: false},
4    {id: 2, body: 'two', published: true}
5  ],
6  comments: [
7    {id: 1, body: 'foo', postId: 1},
8    {id: 2, body: 'bar', postId: 2}
9  ]
10}

getById(collection, id)

Finds and returns document by id or undefined.

1const post = _.getById(db.posts, 1)

insert(collection, document)

Adds document to collection, sets an id and returns created document.

1const post = _.insert(db.posts, { body: 'New post' })

If the document already has an id, and it is the same as an existing document in the collection, an error is thrown.

1_.insert(db.posts, { id: 1, body: 'New post' })
2_.insert(db.posts, { id: 1, title: 'New title' }) // Throws an error

upsert(collection, document)

Adds document to collection, sets an id and returns created document.

1const post = _.upsert(db.posts, { body: 'New post' })

If the document already has an id, it will be used to insert or replace.

1_.upsert(db.posts, { id: 1, body: 'New post' })
2_.upsert(db.posts, { id: 1, title: 'New title' })
3_.getById(db.posts, 1) // { id: 1, title: 'New title' }

updateById(collection, id, attrs)

Finds document by id, copies properties to it and returns updated document or undefined.

1const post = _.updateById(db.posts, 1, { body: 'Updated body' })

updateWhere(collection, whereAttrs, attrs)

Finds documents using _.where, updates documents and returns updated documents or an empty array.

1// Publish all unpublished posts
2const posts = _.updateWhere(db.posts, { published: false }, { published: true })

replaceById(collection, id, attrs)

Finds document by id, replaces properties and returns document or undefined.

1const post = _.replaceById(db.posts, 1, { foo: 'bar' })

removeById(collection, id)

Removes document from collection and returns it or undefined.

1const comment = _.removeById(db.comments, 1)

removeWhere(collection, whereAttrs)

Removes documents from collection using _.where and returns removed documents or an empty array.

1const comments = _.removeWhere(db.comments, { postId: 1 })

id

Overwrite it if you want to use another id property.

1_.id = '_id'

createId(collectionName, doc)

Called by lodash-id when a document is inserted. Overwrite it if you want to change id generation algorithm.

1_.createId = (collectionName, item) => `${collectionName}-${item.prop}-${Date.now()}`

Changelog

See details changes for each version in the release notes.

License

MIT - Typicode :cactus: