mongoose-custom-pagination
Pagination plugin for Mongoose
Installation
npm install mongoose-custom-pagination
Usage
Add plugin to a schema and then use model paginate
method:
var mongoose = ;var mongoosePaginate = ; var schema = /* schema definition */ ;schema; var Model = mongoose; // Model.paginate()
Model.paginate([query], [options], [callback])
Returns promise
Parameters
[query]
{Object} - Query criteria. Documentation[options]
{Object}[select]
{Object | String} - Fields to return (by default returns all fields). Documentation[sort]
{Object | String} - Sort order. Documentation[populate]
{Array | Object | String} - Paths which should be populated with other documents. Documentation[lean=false]
{Boolean} - Should return plain javascript objects instead of Mongoose documents? Documentation[leanWithId=true]
{Boolean} - Iflean
andleanWithId
aretrue
, addsid
field with string representation of_id
to every document[offset=0]
{Number} - Useoffset
orpage
to set skip position[page=1]
{Number}[limit=10]
{Number}[customLabels]
{Object} - Developers can provide custom labels for the response data.
[callback(err, result)]
- If specified the callback is called once pagination results are retrieved or when an error has occurred
Return value
Promise fulfilled with object having properties:
docs
{Array} - Array of documentstotalDocs
{Number} - Total number of documents in collection that match a querylimit
{Number} - Limit that was usedhasPrevPage
{Bool} - Availability of prev page.hasNextPage
{Bool} - Availability of next page.page
{Number} - Current page numbertotalPages
{Number} - Total number of pages.offset
{Number} - Only if specified or defaultpage
/offset
values were usedprevPage
{Number} - Previous page number if available or NULLnextPage
{Number} - Next page number if available or NULL
Examples
Return first 10 documents from 100
Model;
Same query with custom labels
var myCustomLabels = docs: 'data' nextPage: 'next' prevPage: 'prev' totalPages: 'pageCount'; Model;
Or you can do the same with offset
and limit
:
Model;
With promise:
Model;
More advanced example
var query = {};var options = select: 'title date author' sort: date: -1 populate: 'author' lean: true offset: 20 limit: 10; Book;
Zero limit
You can use limit=0
to get only metadata:
Model;
Set custom default options for all queries
config.js:
var mongoosePaginate = ; mongoosePaginatepaginateoptions = lean: true limit: 20;
controller.js:
Model;