转换器会解析 JSON5 风格对象字面量,可选择递归排序 key,再用 @iarna/toml 序列化数据。嵌套对象会成为 TOML table,基本类型数组会成为 TOML array,对象数组会成为 table array。
TOML 没有原生 null 值,目前序列化器会省略 null key 或数组项。函数、computed property、prototype 与 undefined 等可执行 JavaScript 结构不会被转成 TOML。
关于这个主题的常见疑问与实用解答。
JSON5 风格的 JavaScript 对象字面量使用花括号,键名可加引号或不加,并可包含注释与尾随逗号。TOML 使用键值语法搭配 table、注释与原生日期时间类型。函数与 undefined 这类可执行 JavaScript 值不在此转换器的数据模型内。
可以,使用排序下拉菜单将所有 TOML 表格键按字母排序(A 到 Z),或保持 JavaScript 对象中的原始属性顺序。排序会递归应用至每个嵌套 TOML 表格。
TOML 广泛用于配置文件,包括 Rust 的 Cargo.toml、Python 的 pyproject.toml、Hugo 网站配置及许多 CLI 工具。其高可读性的语法使其非常适合人类经常编辑的配置。
不会,JS 对象转 TOML 的转换完全在您的浏览器内进行。您的 JavaScript 代码在本地处理,不会发送至任何远程服务器。