cel-js is a Common Expression Language (CEL) evaluator for JavaScript
MIT License
cel-js
is a powerful and efficient parser and evaluator for Google's Common Expression Language (CEL), built on the robust foundation of the Chevrotain parsing library. This library aims to provide a seamless and easy-to-use interface for working with CEL in JavaScript environments.
Try out cel-js
in your browser with the live demo.
condition ? true : false
)&&
)||
)==
, !=
)<
, <=
, >
, >=
, in
)+
, -
, *
, /
, %
)foo.bar
)foo["bar"]
)exists
, has
, size
, etc.)
exists(foo)
)has(foo, "bar")
)size(foo)
)!true
, -123
)myFunction()
)To install cel-js
, use npm:
npm i cel-js
evaluate
evaluate
is the primary function for parsing and evaluating CEL expressions. It takes an expression string and an optional object of variables to use in the expression.
import { evaluate, parse } from 'cel-js'
// use `evaluate` to parse and evaluate an expression
evaluate('2 + 2 * 2') // => 6
evaluate('"foo" + "bar"') // => 'foobar'
evaluate('user.role == "admin"', { user: { role: 'admin' } }) // => true
parse
parse
is a lower-level function that only parses an expression string into an AST. This can be useful if you want to evaluate the expression multiple times with different variables or if you want to validate the syntax of an expression.
// use `parse` to parse an expression, useful for validation purposes
const result = parse('2 + a')
if (!result.isSuccess) {
// your business logic
}
// you can reuse the result of `parse` to evaluate the expression
evaluate(result.cst, { a: 2 }) // => 4
evaluate(result.cst, { a: 4 }) // => 6