# @jsreport/mingo > JavaScript implementation of MongoDB query language Latest version **2.4.2** (published 2026-08-04) · MIT license · 0 weekly downloads ## Install ```sh npm install @jsreport/mingo pnpm add @jsreport/mingo yarn add @jsreport/mingo bun add @jsreport/mingo ``` ## Health **Score 60/100 (C)** — status: active. Positive: esm support; no vulnerabilities; recently updated; high maintenance score. Warnings: low downloads; no types. ## Facts | | | |---|---| | Version | 2.4.2 | | Published | 2026-08-04 | | First published | 2019-11-06 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | ESM + CommonJS | | Dependencies | 0 | | Unpacked size | 352.2 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 1037 | | Author | Francis Asante | | Maintainers | pofider, bjrmatos | | Keywords | util, mongo, nosql, query, aggregate, filter, group, project, search, transform | ## Links - npm: https://www.npmjs.com/package/@jsreport/mingo - Repository: https://github.com/kofrasa/mingo - Homepage: https://github.com/kofrasa/mingo#readme - Issues: https://github.com/kofrasa/mingo/issues - npm.io page: https://npm.io/package/@jsreport/mingo ## Alternatives - [angular-pipes](https://npm.io/package/angular-pipes.md) — 5.6K weekly downloads - [@ng-web-apis/midi](https://npm.io/package/@ng-web-apis/midi.md) — 2.6K weekly downloads - [happn-3](https://npm.io/package/happn-3.md) — 1.6K weekly downloads - [@opensip-cli/lang-go](https://npm.io/package/@opensip-cli/lang-go.md) — 1.2K weekly downloads - [mongoose-typescript](https://npm.io/package/mongoose-typescript.md) — 85 weekly downloads ## Recent versions - 2.4.2 (latest) — 2026-08-04 - 2.4.1 — 2019-11-06 ## README # mingo JavaScript implementation of MongoDB query language [![version](https://img.shields.io/npm/v/mingo.svg)](https://www.npmjs.org/package/mingo) [![build status](https://img.shields.io/travis/kofrasa/mingo.svg)](http://travis-ci.org/kofrasa/mingo) [![npm](https://img.shields.io/npm/dm/mingo.svg)](https://www.npmjs.org/package/mingo) [![Codecov](https://img.shields.io/codecov/c/github/kofrasa/mingo.svg)](https://codecov.io/gh/kofrasa/mingo) [![Code Quality: Javascript](https://img.shields.io/lgtm/grade/javascript/g/kofrasa/mingo.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/kofrasa/mingo/context:javascript) [![Total Alerts](https://img.shields.io/lgtm/alerts/g/kofrasa/mingo.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/kofrasa/mingo/alerts) ## Install ```$ npm install mingo``` ## Features - Supports Dot Notation for both _`.`_ and _`.`_ selectors - Query and Projection Operators - [Array Operators](https://docs.mongodb.com/manual/reference/operator/query-array/) - [Comparisons Operators](https://docs.mongodb.com/manual/reference/operator/query-comparison/) - [Element Operators](https://docs.mongodb.com/manual/reference/operator/query-element/) - [Evaluation Operators](https://docs.mongodb.com/manual/reference/operator/query-evaluation/) - [Logical Operators](https://docs.mongodb.com/manual/reference/operator/query-logical/) - Aggregation Framework Operators - [Pipeline Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-pipeline/) - [Group Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-group/) - [Projection Operators](https://docs.mongodb.com/manual/reference/operator/projection/) - [Arithmetic Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-arithmetic/) - [Array Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-array/) - [Boolean Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-boolean/) - [Comparisons Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-comparison/) - [Conditional Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-conditional/) - [Date Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-date/) - [Literal Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-literal/) - [Set Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-set/) - [String Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-string/) - [Variable Operators](https://docs.mongodb.com/manual/reference/operator/aggregation-projection/) - Support for adding custom operators - Match against user-defined types - Support for aggregaion variables - [`$$ROOT`,`$$CURRENT`,`$$DESCEND`,`$$PRUNE`,`$$KEEP`,`$$REMOVE`](https://docs.mongodb.com/manual/reference/aggregation-variables/) - ES6 module compatible - Support integrating with custom collections via mixin - Query filter and projection streaming. For documentation on using query operators see [mongodb](http://docs.mongodb.org/manual/reference/operator/query/) ## Documentation - [API](https://github.com/kofrasa/mingo/wiki/API) - [Custom Operators](https://github.com/kofrasa/mingo/wiki/Custom-Operators) ## Usage On the server side ```js // Use as es6 module import mingo from 'mingo' // or vanilla nodeJS var mingo = require('mingo') ``` For the browser ```html // minified UMD module // or gzipped UMD module ``` Tiny configuration if needed ```js // setup the key field for your collection mingo.setup({ key: '_id' // default }); ``` ## Using query object to test objects ```js // create a query with criteria // find all grades for homework with score >= 50 let query = new mingo.Query({ type: "homework", score: { $gte: 50 } }); // test if an object matches query query.test(someObject) ``` ## Searching and Filtering ```js // input is either an Array or any iterable source (i.e Object{next:Function}) including ES6 generators. // filter collection with find() let cursor = query.find(collection) // shorthand with query criteria cursor = mingo.find(collection, criteria) // sort, skip and limit by chaining cursor.sort({student_id: 1, score: -1}) .skip(100) .limit(100) // count matches. exhausts cursor cursor.count() // classic cursor iterator (old school) while (cursor.hasNext()) { console.log(cursor.next()) } // ES6 iterators (new cool) for (let value of cursor) { console.log(value) } // all() to retrieve matched objects. exhausts cursor cursor.all() ``` ## Aggregation Pipeline ```js let agg = new mingo.Aggregator([ {'$match': { "type": "homework"}}, {'$group':{'_id':'$student_id', 'score':{$min:'$score'}}}, {'$sort':{'_id': 1, 'score': 1}} ]) // return an iterator for streaming results let stream = agg.stream(collection) // return all results. same as `stream.all()` let result = agg.run(collection) ``` ## Integration with custom collection ```js // using Backbone.Collection as an example (any user-defined object will do) let Grades = Backbone.Collection.extend(mingo.CollectionMixin) // `collection` is an array of objects let grades = new Grades(collection) // find students with grades less than 50 in homework or quiz // sort by score ascending and type descending cursor = grades.query({ $or: [{type: "quiz", score: {$lt: 50}}, {type: "homework", score: {$lt: 50}}] }).sort({score: 1, type: -1}).limit(10) // return grade with the lowest score cursor.next() ``` The collection to mixin needs to provide a method with signature `toJSON() -> Array[Object]`. ## Why? - Alternative to writing lots of custom code for transforming collection of objects - Quick validation of MongoDB queries without the need for a database - MongoDB query language is among the best in the market and is well documented ## Contributing * Submit pull requests to the [development](https://github.com/kofrasa/mingo/tree/development) branch * Squash changes into one commit * Run `make` to ensure tests pass ## License MIT --- _Source: https://npm.io/package/@jsreport/mingo · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._