cel-javascript

Not production ready yet

Common Expression Language for JavaScript

The Common Expression Language (CEL) is a non-Turing complete language designed for simplicity, speed, safety, and portability. The goal of this library is to adhere to the language definition of CEL and enable its use within a JavaScript project.

This library uses Peggy to match the CEL language definition. To utilize the pegjs file for making modifications, you can copy the following File and access the Online Editor. There, you can directly test the parser's outcomes.

Installation

To install cel-javascript:

npm install cel-javascript 

Usage

Presently, it's possible to evaluate a string without custom types. To do so, add the following line:

import { parseString } from 'cel-javascript';

And then you can do the following:

parseString("0"); // => {int64_value: 0}
parseString("0u"); // => {uint64_value: 0}
parseString("r'banana'"); // => {string_value: "banana"}
parseString("10 + 10 + 10"); // => {double_value: 30}
parseString("3 > 2 ? 1 : 4"); // => {int64_value: 1}

Additionally, you can use custom types by adding:

import { parseStringWithOptions } from 'cel-javascript';

To utilize custom types, pass a JSON object as a String to the function for reference:

let json = `{"banana": {"score": 1}}`
parseStringWithOptions("banana.score", json); // => {int64_value: 1}

The reason why it currently needs the JSON as a string is that I was currently not able because of the limitation of javascript and how it handles numbers to make sure that 1.0 would be read as a double instead of an int. To currently fix this I added the lossless-json library which enables me to at the time of fetching the value make the correct call to return a Double, Int64 or String value. This is something I want to try to fix in the future.