TASON (Type-Augmented Serialization Object Notation，发音/ˈtæsən/) 是一种类型化的对象表示语法，可以用于序列化和反序列化数据。
本仓库为原始JavaScript/TypeScript实现，其他语言的实现可以参考以下项目：
- .NET/C#： tason-net
TASON的三大特性：人类可读、自描述强类型和动态结构
- TASON是一种文本序列化，语法是JSON的超集，使用起来非常方便。
- 在保留绝大部分JSON5对JSON的语法简化的同时，移除了少数容易产生混淆的语法和空白字符，以减低手工编写时的错误率。
- TASON的语法包含了类型信息，不需要额外的描述文件，因此可以非常方便的进行反序列化。
- TASON类型是语言无关的，即使是TASON内置类型，具体的实现也取决于所使用的语言，只需要语义上的一致即可
- 支持类型判别器(discriminator)、创建类型别名和指定序列化类型，实现多态序列化、多对一反序列化、鸭子类型序列化
- TASON支持动态结构，对象可以包含任意数量的属性，或者将动态对象和固定类型对象混合使用。
- 在
Protocol Buffers(gRPC),MessagePack等二进制序列化中， 为了表达动态结构，仍然需要通过内嵌JSON字符串等方式进行降级，反而降低了其性能和强类型优势
- 低代码平台、企业数据中台、数据仓库、仪表盘、BI分析等所使用的高度动态化查询结果，可以同时实现强类型，自描述和人类可读的数据格式。
- 含有动态类型的非关系型数据库如MongoDB的无损数据查询和保存。MongoDB支持在查询中使用复杂类型， 如果使用传统基于JSON的API接口传递参数，例如传递字符串形式的Date, Int64和RegExp，可能会在查询动态结构文档时，类型不匹配而查询不到数据。 事实上，MongoDB管理工具展现数据的格式和TASON非常相似，也是其灵感来源之一
- 将接口数据反序列化为JavaScript类，从而简化JavaScript基于实体类的跨平台/同构(isomorphic)应用开发
- 编写强类型的配置文件，直接获得配置对象实例，解决JSON弱类型带来的反序列化复杂性
- 配合SOAP, GraphQL等已有的强类型数据和服务规范，推出简化的Web API
详细语法见此ANTLR4语法文件 TASON.g4
TASON语法以JSON5为蓝本，去掉了少数易混淆的语法，并增强了类型支持。
以下是一个TASON文件示例，来表达MongoDB的一个文档记录：
{
_id: ObjectId("6670f391dcb0bd791cb3bd18"),
id: UUID("3e5b933e-adc1-48a8-b0f8-30aa701cfd77"),
"$type": "com.alibaba.fastjson.JSONObject",
name: "Pilipili Corporation",
createTime: Date("2025-01-01T00:00:00.000Z"),
reportDate: '2024-12',
financial: {
totalAsset: 6.66e11,
totalDebt: +9876547210.33,
netProfit: Decimal128("114514.1919"),
},
legalPerson: User({
id: Int64("6571037680684232705"),
name: "🤣👉🤡👈🤣",
age: 24
}),
keywords: ["线下PVP", '本子', "femboy", ]
}- 类型系统说明 — 语法类型、内置类型与规范约定
- 数值处理 — 序列化/反序列化数值装箱与拆箱策略
- 实体元数据与 Schema — 用 Valibot 等契约把字段收成
bigint/Date等运行时类型 - 正则表达式 —
RegExp类型实例与选项
主要的类为 TASONSerializer，提供 parse 和 stringify。
构造函数可配置缩进、最大嵌套、重复键、数值处理等行为。
包的默认导出 TASON 是带合理默认参数的 TASONSerializer 实例，可直接使用；需要独立配置时用 new TASON.Serializer({ ... })。
npm install tason
# or
yarn add tason
# or
pnpm add tasontason 仅支持 ESM：前端需打包器（Vite、webpack 等）；Node.js 需原生 ESM。
使用 实体 Schema 时，请额外安装可选依赖：
npm install valibotimport TASON from 'tason';
class Person {
name: string;
age: number;
constructor(name = "", age = 0) {
this.name = name;
this.age = age;
}
}
TASON.registry.registerType("Person", {
kind: "object",
ctor: Person,
});
const people = TASON.parse<Person[]>(
`[
Person({
"name": "John",
"age": 30
}),
// 可以包含注释
Person({
name: 'Jane',
age: 25,
}),
]`);默认会将 Int64("…") 等拆成原生 bigint / number。需要保留包装类时：
const s = new TASON.Serializer({ deserializeNumberHandling: "all" });
s.parse(`Int64("42")`); // Int64 实例import TASON from 'tason';
const serializer = new TASON.Serializer({
indent: 2, // 缩进 2 空格
registry: TASON.registry.clone(), // 复用全局类型注册表
});
const people = [
new Person("John", 30),
new Person("Jane", 25),
];
console.log(serializer.stringify(people));默认仅在数值超出安全范围时写出类型名；需要尽量带类型名时使用 serializeNumberHandling: "all"。详见 数值处理。
仅 registerType 只能得到类实例，字段值的 JS 类型仍受数值处理默认策略影响。
若希望 id 稳定为 bigint、when 为 Date 等，可为类型挂上 schema（官方适配 Valibot）：
import TASON, { createValibotAdapter } from "tason";
import * as v from "valibot";
class User {
id!: bigint;
name!: string;
constructor(init?: Partial<User>) {
if (init) Object.assign(this, init);
}
}
TASON.registry.setSchemaAdapter(createValibotAdapter());
TASON.registry.registerType(
"User",
{ kind: "object", ctor: User },
{ schema: v.object({ id: v.bigint(), name: v.string() }) },
);
const u = TASON.parse<User>(`User({ id: Int64("1"), name: "Ada" })`);
// u.id === 1n如何挂接 schema、自定义 adapter（含 Zod 示例）见 实体元数据与 Schema。