97 lines
1.7 KiB
Markdown
97 lines
1.7 KiB
Markdown
---
|
|
title: "json-query-chain"
|
|
date: 2018-02-23
|
|
---
|
|
|
|
> Chain queries onto POJOs to return precise results.
|
|
|
|
<!--more-->
|
|
|
|
[Fork on Gitlab](https://gitlab.com/gaiety/json-query-chain)
|
|
|
|
# json-query-chain
|
|
|
|
[](https://travis-ci.org/sharpshark28/json-query-chain) [](https://badge.fury.io/js/json-query-chain)  [](https://codeclimate.com/github/sharpshark28/json-query-chain/maintainability)
|
|
|
|
Chain queries onto POJOs to return precise results.
|
|
|
|
## Usage
|
|
|
|
```javascript
|
|
import Query from 'json-query-chain';
|
|
|
|
let myQ = new Query(someJsonData)
|
|
.search('isActiveUser', true)
|
|
.results;
|
|
```
|
|
|
|
### Chainable Methods
|
|
|
|
#### Search
|
|
|
|
Currently supports booleans and strings. (See [#1](https://github.com/hergaiety/json-query-chain/issues/1) for Integer Support)
|
|
|
|
##### By Boolean
|
|
|
|
```javascript
|
|
.search('isActiveUser', true)
|
|
```
|
|
|
|
##### By String
|
|
|
|
```javascript
|
|
.search('name', 'steele')
|
|
```
|
|
|
|
#### Filter
|
|
|
|
Simpler version of search using a custom function in the chain.
|
|
|
|
```javascript
|
|
.filter(a => a.age >= 21)
|
|
```
|
|
|
|
##### By Key
|
|
|
|
```javascript
|
|
.filterBy('age', x => x >= 21)
|
|
```
|
|
|
|
#### Sort
|
|
|
|
##### By Boolean
|
|
|
|
```javascript
|
|
.sort('isActiveUser', true)
|
|
```
|
|
|
|
##### By String
|
|
|
|
```javascript
|
|
.sort('name')
|
|
```
|
|
|
|
##### By Number
|
|
|
|
```javascript
|
|
.sort('netWorth')
|
|
```
|
|
|
|
#### Pagination
|
|
|
|
Page 1 with 5 results per page.
|
|
|
|
```javascript
|
|
.paginate(1, 5)
|
|
```
|
|
|
|
Page 2 wtih default of 10 results per page.
|
|
|
|
```javascript
|
|
.paginate(2)
|
|
```
|
|
|
|
## Tests
|
|
|
|
`npm test` runs tests through Jest
|
|
|