Ajoq NPM | npm.io

AJOQ

Another Javascript Object Query.

Uses mongodb like query structure to execute in function

Installation

npm install ajoq

Usage

Filter function

import { createFilter } from "ajoq";

interface Data {
  name: string;
  age: number;
  // data type
}
const values: Data[] = [{ name: 'John', age: 42 }, { name: 'Jane', age: 18 }];

const filterFn = createFilter<Data>({ name: 'John', age: { $gte: 21 } });
const filtered = values.filter(filterFn); // [{ name: 'John', age: 42 }]

Sort function

import { createSort } from "ajoq";

interface Data {
  name: string;
  age: number;
  // data type
}
const values: Data[] = [{ name: 'John', age: 42 }, { name: 'Jane', age: 18 }];

const sortFn = createSort<Data>({ name: 'asc', age: -1 });
const sorted = values.toSorted(sortFn); // [{ name: 'John', age: 42 }, { name: 'Jane', age: 18 }]

Documentation

Filter

The Filter type represents a flexible and expressive way to filter and search data. It supports combining conditions with logical operators, making it suitable for complex query requirements.

Logical Operators

$and: Matches if all sub-conditions are true (logical AND).
$or: Matches if at least one sub-condition is true (logical OR).
$nor: Matches if none of the sub-conditions are true (logical NOR).
$not: Matches if the sub-condition is false (logical NOT).

Filter Operators

$eq: Matches if the field equals the value.
$ne: Matches if the field does not equal the value.
$gt: Matches if the field is greater than the value.
$gte: Matches if the field is greater than or equal to the value.
$lt: Matches if the field is less than the value.
$lte: Matches if the field is less than or equal to the value.
$exists: Matches if the field exists or does not exist (true or false).
$match: Matches if the field value matches a regex or string.
$nmatch: Matches if the field value does not match a regex or string.
$bits: Matches if any bits from the field value match the specified bitmask.
$nbits: Matches if no bits from the field value match the specified bitmask.
$type: Matches if the field's type matches the specified type.
$ntype: Matches if the field's type does not match the specified type.
$in: Matches if the field value is in the specified array.
$nin: Matches if the field value is not in the specified array.
$sub: Matches if all elements of the field array are in the specified array (subset).
$nsub: Matches if the field array is not a subset of the specified array.
$sup: Matches if the field array contains all elements of the specified array (superset).
$nsup: Matches if the field array does not contain all elements of the specified array.
$con: Matches if the field array contains the specified value.
$ncon: Matches if the field array does not contain the specified value.