Need help with queryl?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

jviotti
414 Stars 15 Forks 40 Commits 0 Opened issues

Description

:mag_right: Query language to perform complex object searches

Services available

!
?

Need anything else?

Contributors list

# 10,489
pkg
nsis
msi
npm
12 commits
# 290,708
JavaScr...
CSS
1 commit

queryl

Query language to perform complex object searches.

npm version dependencies Build Status Build status

Description

Queryl allows to to build complex queries to match JavaScript objects. This can be useful to:

  • Search collections of objects (even heterogeneus).
  • Validate objects.
  • Assert properties of an object for testing purposes.

Installation

Install

queryl
by running:
$ npm install --save queryl

Documentation

queryl.match(query, object) ⇒ Boolean

Kind: static method of queryl
Summary: Query an object
Returns: Boolean - whether it matches or not
Access: public

| Param | Type | Description | | --- | --- | --- | | query | Object | query | | object | Object | object |

Example
```js queryl.match({ $or: { $equal: { foo: 'bar' }, $and: { $not: { $match: { foo: /^baz/ } }, $gt: { bar: 3 } } } }, { foo: 'hello world', bar: 5 });

true

**Example**  
js queryl.match({ $contain: { 'foo.bar': 2 } }, { foo: { bar: [ 1, 2, 3 ] } }); true
**Example**  
js queryl.match({ $contain: { 'foo.bar': { baz: 6 } } }, { foo: { bar: [ 1, 2, { baz: 6 } ] } }); true ```

Operations

operations.$and()

Kind: static method of operations
Properties

| Name | Type | Description | | --- | --- | --- | | $and | function | logical conjunction |

Example
```js queryl.match({ $and: { $equal: { foo: 'bar' }, $match: { bar: /^hello/ } } }, { foo: 'bar', bar: 'hello world' });

true ```

operations.$or()

Kind: static method of operations
Properties

| Name | Type | Description | | --- | --- | --- | | $or | function | logical disjunction |

Example
```js queryl.match({ $or: { $equal: { foo: 'bar' }, $match: { bar: /^hello/ } } }, { foo: 'bar', bar: 'hey there' });

true ```

operations.$not()

Kind: static method of operations
Properties

| Name | Type | Description | | --- | --- | --- | | $not | function | logical negation |

Example
```js queryl.match({ $not: { $equal: { foo: 'bar' } } }, { foo: 'baz' });

true ```

operations.$equal()

This operation supports deep equality.

Kind: static method of operations
Properties

| Name | Type | Description | | --- | --- | --- | | $equal | function | equality |

Example
```js queryl.match({ $equal: { foo: 'bar' } }, { foo: 'bar' });

true ```

operations.$contain()

This operation supports deep equality.

Kind: static method of operations
Properties

| Name | Type | Description | | --- | --- | --- | | $contain | function | collection include |

Example
```js queryl.match({ $contain: { foo: 1 } }, { foo: [ 1, 2, 3 ] });

true ```

operations.$match()

Kind: static method of operations
Properties

| Name | Type | Description | | --- | --- | --- | | $match | function | RegExp match |

Example
```js queryl.match({ $match: { foo: /^hello/ } }, { foo: 'hello world' });

true ```

operations.$gt()

Kind: static method of operations
Properties

| Name | Type | Description | | --- | --- | --- | | $gt | function | greater than |

Example
```js queryl.match({ $gt: { foo: 5 } }, { foo: 6 });

true ```

operations.$lt()

Kind: static method of operations
Properties

| Name | Type | Description | | --- | --- | --- | | $lt | function | less than |

Example
```js queryl.match({ $lt: { foo: 5 } }, { foo: 4 });

true ```

Support

If you're having any problem, please raise an issue on GitHub and I'll be happy to help.

Tests

Run the test suite by doing:

$ gulp test

Contribute

Before submitting a PR, please make sure that you include tests, and that jshint runs without any warning:

$ gulp lint

License

The project is licensed under the MIT license.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.