tvl-depot/users/wpcarro/slx.js/README.md
William Carroll 509e356bb8 feat(wpcarro/slx.js): Support JavaScript simple-select impl
See README.md

Change-Id: I6a50e34398c42aabe3cceba160be006f1867eca4
Reviewed-on: https://cl.tvl.fyi/c/depot/+/7874
Reviewed-by: wpcarro <wpcarro@gmail.com>
Autosubmit: wpcarro <wpcarro@gmail.com>
Tested-by: BuildkiteCI
2023-01-19 18:12:59 +00:00

1.5 KiB

slx.js

Filter tabular data in the browser using an ergonomic query language.

Status

This project is usable today (I use it in my projects), but it's currently alpha status. See the wish list for remaining features.

Installation

slx.js is available via CDN:

<script src="https://cdn.jsdelivr.net/gh/wpcarro/slx.js/index.js" async></script>

Usage

slx.js hasn't been properly benchmarked, but in my personal projects, it works fine with O(1,000)s of records.

const cast = [
  { first: "Graham", last: "Chapman" },
  { first: "John", last: "Cleese" },
  { first: "Terry", last: "Gilliam" },
  { first: "Eric", last: "Idle" },
  { first: "Terry", last: "Jones" },
  { first: "Michael", last: "Palin" },
];

const config = {
    // Match values case sensitively when filtering.
    caseSensitive: false,
    // Coerce values into regular expressions (instead of strings) when they're defined as atoms.
    preferRegex: true,
    // The key in the JS object that hosts the Date type against which we filter.
    dateKey: 'Date',
};

console.log(select('last:^C.+$', cast, config));
// [{ first: "Graham", last: "Chapman" }, { first: "John", last: "Cleese" }]

Wish List

  • Support explicit grouping with parentheses (e.g. title:once (director:Tarantino OR director:Coen)).
  • Proper benchmarking (see "Usage" section).
  • Something something documentation.
  • Something something testing.

See also: