jslt-js

JavaScript端口 JSLT - JSON查询和转换语言。 忠实地翻译Java引擎：相同的语法，相同的内置程序，相同的语义。 同构（浏览器+ Node.js），零运行时依赖。

在操场上试试 -具有语法高亮显示、错误标记和可共享链接的实时xslt编辑器。

对于Java开发人员

如果你知道Java xslt库，这直接映射：

快速启动

import { compile, fromJS, toJS } from "jslt-js";

const expr = compile(`.name + " wins"`, "example.jslt");
const result = toJS(expr.applyInput(fromJS({ name: "Alice" })));
// → "Alice wins"

安装

npm install jslt-js          # ESM (Node 18+, browsers)

浏览器(经典脚本/ file:// /没有捆绑器)： 使用预构建的IIFE -它设置 globalThis.JSLT (与ESM API的形状相同，包括 extensions）：

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/jslt-bundle.js"></script>
<script>
  const expr = JSLT.compile('{"hi": .name}');
  console.log(JSLT.toJS(expr.applyInput(JSLT.fromJS({ name: "Ada" }))));
</script>

做。 不 依靠 https://esm.sh/jslt-js@…?bundle 对于浏览器-旧的发布被拉出 node:crypto 到图中。更喜欢 dist/jslt-bundle.js (或ESM from [email protected]+）.

CJS使用者(require()）：

const { compile, fromJS, toJS } = require("jslt-js");

CJS构建在 dist/jslt.cjs 并通过。自动选择 exports 字段。

API

compile(source, sourceName, options?)

解析和编译xslt模板。返回一个 ExpressionImpl。

const expr = compile(source, "my-transform.jslt", {
  resolver: { resolve: (name) => fs.readFileSync(name, "utf8") },
  functions: myCustomFunctions,   // array of Function objects
});

选项:

对象关键字过滤器

缺省情况下，对象键的值为 null， {} 或 [] 从输出中省略。要改变这一点，请通过 objectFilter：

import { compile, TrueJsonFilter } from "jslt-js";

compile(source, name, { objectFilter: new TrueJsonFilter() });   // keep every key
compile(source, name, { objectFilter: "true" });                 // same, as a JSLT expression
compile(source, name, { objectFilter: ". != null" });            // drop only nulls

DefaultJsonFilter， TrueJsonFilter， JsltJsonFilter （包装编译后的表达式）和 JsonFilter 导出基类。

expr.applyInput(inputNode)

将编译后的表达式应用于 JsonNode 输入。

expr.applyVariables(vars, inputNode)

应用于外部变量。 vars 是一个纯JS对象映射变量名称 JsonNode 价值观:

expr.applyVariables({ foo: fromJS(42) }, fromJS(null));

fromJS(value) / toJS(node)

在普通JS值和内部代码之间进行转换 JsonNode 树。 toJS 安全吗？ JSON.stringify 大整数从 BigInt 当他们适合一个JS号码。

readTree(jsonString)

将JSON字符串解析为a JsonNode． 相当于杰克逊的 ObjectMapper.readTree 在大多数情况下。 注意: 使用 JSON.parse 在内部，所以整值浮点数("42.0")回来 IntNode(42) -相同类型擦除限制 和任何JS JSON解析器一样。xslt表达式和模板不受影响，因为引擎对文字使用自己的类型感知词法分析器。

进口

JSLT import 语句通过 resolver 选择:

// File-system resolver (Node only)
import { readFileSync } from "fs";
import { resolve, dirname } from "path";

const jsltDir = dirname(jsltFilePath);
const opts = {
  resolver: { resolve: (name) => readFileSync(resolve(jsltDir, name), "utf8") },
};
const expr = compile(source, jsltFilePath, opts);

扩展函数

注册自定义函数的方式与Java相同 Parser.withFunctions：

const myFn = {
  getName: () => "greet",
  getMinArguments: () => 1,
  getMaxArguments: () => 1,
  call: (_input, [nameNode]) => fromJS("Hello " + nameNode.asText()),
};

const expr = compile(`. | greet(.name)`, "t.jslt", { functions: [myFn] });

该库附带了一个可选择的扩展包。这些都不是普通的xslt函数，也没有重用内置名称(stock flatten() 递归并接受一个参数stock sum() 抛出一个非数字，所以包的版本是 flattened() 和 summed()）：

它们反映了Java主机的自定义函数，并根据相同的函数进行检查 test/resources/function-parity.json。

import { extensions } from "jslt-js/extensions";

const expr = compile(source, name, { functions: extensions });

CLI

npx jslt [--extensions] <transform.jslt> [input.json|-]

读取JSON input.json 或stdin。 --extensions 加载内置扩展包。导入解析相对于 <transform.jslt>的目录。

echo '{"name":"Alice"}' | jslt greet.jslt -
cat booking.json | jslt --extensions ext.jslt -

构建

npm run build     # → dist/jslt-bundle.js (browser global) + dist/jslt.cjs (Node CJS)

浏览器包暴露了 globalThis.JSLT 完整的API，包括扩展。

测试

npm test

运行单元测试和上游一致性fixture (query-tests.json， function-tests.json， function-declaration-tests.yaml等), 供应商从 schibsted / jslt ——看 test/resources/SOURCE.md 对于确切的上游提交。

一致性套件是此端口的主要正确性契约，而不是附带的测试。 下面的每个文件 src/ 是排队吗 // Port of X.java 翻译;“它是否不加更改地通过上游fixture”定义了与Java引擎的奇偶性，并且 这可以通过重新同步来针对未来的上游版本进行重新验证 test/resources/。

所有上游的合格装置都以零跳过通过。YAML fixture需要 js-yaml (devDependency)。

平价笔记

• 数值类型：与Jackson完全匹配 IntNode/LongNode/BigIntegerNode/DoubleNode 与十字头式 equals （Jackson 2.6+语义）。
• parse-time/format-time：通过 Intl.DateTimeFormat． 支持Java SimpleDateFormat令牌(yyyy MM dd HH mm ss S/SS/SSS z Z X）. 返回/接受自Unix纪元以来的秒数（双精度），与Java相同。
• 实验模块： import "http://jslt.schibsted.com/2018/experimental" 开箱即用-提供 group-by。
• FunctionWrapper：未移植-在Java中，它封装了静态 Method 通过反射。在JS中，任何带有 {getName, getMinArguments, getMaxArguments, call} 已经是一个xslt函数，不需要包装器。
• parse-url：通过WHATWG URL实现。省略了 path 当原始URL没有显式路径（匹配）时 java.net.URL.getPath() 返回 ""）.
• 从Java API延迟： ClasspathResourceResolver， FileSystemResourceResolver (使用 resolver 选项)，以及REPL/playground。

生态系统

JSLT有一个小而多样的生态系统，由几个作者创建，包括本端口的作者。状态截止到2026年10月，因此请查看每个项目的当前状态。

实现

工具和IDE插件

• JSLT演示 （源)：上游项目的游乐场，它在服务器上运行Java引擎
• jslt-editor一个可嵌入的CodeMirror 6编辑器，具有高亮显示、补全、悬停文档、格式化和错误标记。
• jslt-intellij-plugin： IntelliJ ide；突出显示、导航、重命名、验证和执行对话框。
• jslt-lang： Visual Studio Code的语法高亮显示，在Visual Studio Marketplace上。
• jslt-language-server： LSP服务器（诊断、补全、悬停、格式化），用于任何使用LSP的编辑器。
• jslt-playground （打开它)：纯JS实现，在浏览器中运行，带有用于导入、JSON或XML输入和输出以及可共享链接的选项卡。
• jslt.tmbundle: TextMate软件;突出显示，符号列表，片段，“检查语法”和“应用到JSON”操作。
• Pygments提供了一个JSLT词法分析器 .jslt 文件，Python和文档工具。
• vscode-jslt： Visual Studio Code和fork (Cursor, VSCodium)；高亮显示，实时错误检查，完成，悬停文档，格式化，片段和“JSLT：应用到JSON文件…”

与Java库一起使用

列于 上游的自述: Apache Camel xslt组件， Apache NiFi 作为处理器， Kafka Connect在Willhaben.at进行转换， 用于业务自动化的IBM Cloud Pak 和 针形事件溯源框架。

了解更多

关于语言设计的演讲 （幻灯片), 一篇论文 描述了Schibsted是如何使用xslt的。