在TypeScript和JavaScript如何使用MetaMessage?

简介: MetaMessage 是一种跨语言数据交换协议,支持 TypeScript/JavaScript(通过装饰器自动类型转换)、JSONC 文本与紧凑二进制 wire 格式,兼顾可读性、精度(如 bigint 表示 int64)与性能,旨在替代 JSON、Protobuf 等传统序列化方案。

截屏2026-05-18 23.28.54.png
截屏2026-05-18 23.30.29.png

在TypeScript和JavaScript如何使用MetaMessage?

本來是不報信心的,因為ts和js天生類型缺失,作為一個動態語言,number既不是int也不是bigint,開始設計的時候想了挺長時間。

還好,確認了ts是支持裝飾器的,雖然也寫過很多前端項目,卻從來沒有用過這個裝飾器。既然有裝飾器,那就非常適合MetaMessage改造,簡單的方式就可以把值進行轉換。對於一些類型,為了不丟失精度,int/int64/uint/uint64需要用bigint來表示,這點需要注意。

看一個例子:

import {
    encodeFromJsonc, decodeToJsonc } from 'metamessage';

@mm({
    desc: '用户' })
class User {
   
  @mm({
    type: ValueType.Int64, desc: '用户ID' })
  id: bigint = 0n;

  @mm({
    desc: '昵称', nullable: false })
  name: string = '';

  @mm({
    type: ValueType.Uint8, desc: '年龄' })
  age: number = 0;
}

const u = new User();
u.id = 666n;
u.name = 'abc';
u.age = 20;

const wire = encodeFromValue(u);
console.log('wire', wire);

const decoded = decodeToValue(wire, User);
console.log('decoded', decoded);

const jsonc = `
// mm: desc="用户"
{
  // mm: type=i64; desc="用户ID"
  "id": 666,

  // mm: desc="昵称"
  "name": "abc",

  // mm: type=u8
  "age": 20
}
`;

const wire = encodeFromJsonc(jsonc);
const jsoncString = decodeToJsonc(wire);
console.log('JSONC result:\n', jsoncString);

上面用一個mm裝飾器來包裹mm的標籤,desc可以描述字段信息,用戶可以從中了解輸出的數據意義。
特殊的類型 比如ValueType.Int64是需要標注的,這樣類型極少的js也可以表示複雜的數據類型了。
nullable代表數據是否可以為空,這在請求描述上特別有用,nullable說明字讀是可選的,當然可以搭配allow_empty,效果更佳。

說下這裡的jsonc,這是一種mm可以表示的文本形式,各語言可能數據對象不一致,但如果輸出jsonc,相同語意的jsonc是一致的。所以各語言間是可以表示相同語意的,且不會出錯。

wire是一種序列化的二進制形式,佔用空間小,也方便解析,可以在網絡傳輸中直接用它。

MetaMessage目前已經支持不少語言了。不過還有很多語言支持在路上,未來作為一種各語言間理想的數據交換工具,一定會流行開來。

替代傳統的json、protobuf、messagePack等老舊協議指日可待。

目录
相关文章
|
4月前
|
JavaScript 文件存储 数据安全/隐私保护
打造你的私人电子书王国:Talebook 项目全面介绍
Talebook 以其简洁的部署、优雅的界面和强大的功能,成为了这个领域不可多得的好项目。
1006 127
|
4月前
|
机器学习/深度学习 人工智能 自然语言处理
Agent = Model + Harness:模型决定上限Harness 决定下限
Claude Code、Cursor等并非聊天界面,而是AI编码的“操作系统”——Harness。它决定模型能否稳定执行规则、调用工具、管理上下文与权限。模型定上限,Harness定下限。差异常源于Harness配置,而非模型本身。
749 5
|
2月前
|
弹性计算 缓存 负载均衡
可用架构实践:阿里云支撑跑腿平台稳定运行,分账链解决交易结算核心痛点
同城跑腿、即时代办、即时配送属于典型的高并发、短时效、强交易、高波动业务场景:节假日、午晚高峰、暴雨暴雪天气会瞬间触发流量峰值,订单秒级涌入;同时每一笔订单都涉及用户、平台、入驻商户、跑腿个人师傅四方交易分润,业务链路复杂。 对于开发者而言,跑腿平台上线运营核心要解决两大问题:业务层高可用稳定承载 + 交易层合规自动化分账。 绝大多数成熟跑腿平台,均基于阿里云云原生架构实现业务稳定、弹性扩容、故障自愈,保障全时段服务可用;而针对行业专属的多方分账、高分润、逆向退款、合规清算难题,行业通用最优解是垂直场景专用系统——分账链。 本文从阿里云架构落地、业务痛点拆解、交易分账解决方案三个维度,完整复盘
425 122
|
2月前
|
缓存 Rust 安全
Nolang 硬核技术白皮书:全方位内核级超越 Rust(纯语言机制对比)
Nolang 是新一代无GC内存安全语言,首创“延迟所有权”模型:赋值直觉、零生命周期负担、函数末尾批量内存回收,性能与安全全面超越Rust。当前生态尚小,但内核、架构与开发体验已实现碾压式领先。(239字)
296 3
|
11天前
|
人工智能 Ubuntu Linux
CC Switch怎么用:添加供应商、一键切换全攻略(全网最详细)
CC Switch 是一款免费开源的桌面工具,专为统一管理 AI 编程工具(如 Claude Code、Codex、Gemini CLI)的 API 供应商而设计。它提供图形化界面,支持一键切换官方/中转/自建供应商,集成 MCP、提示词、Skills 管理及用量统计,大幅简化配置流程。(239字)
|
3月前
|
人工智能 自然语言处理 测试技术
告别手动画图:用自然语言生成可直接发布的 SVG+PNG 技术图
`fireworks-tech-graph`它把技术图这件事,从一次性手工劳动,变成了一种可以沉淀、复用、批量生成的 Skill 能力。在 AI/Agent 相关内容越来越多的背景下,这是一个很值得试一下的项目。
485 10
告别手动画图:用自然语言生成可直接发布的 SVG+PNG 技术图
|
4月前
|
前端开发 程序员 开发工具
初级程序员必备的十大技能之开发工具熟练使用(四)
教程来源 https://tmywi.cn/ VS Code深度集成Git:快捷键操作、冲突可视化解决;GitLens增强代码溯源与历史追踪;配合高效命令行别名与撤销技巧;辅以Node/前端多维调试方案,全面提升开发效能。
|
3月前
|
人工智能 自然语言处理 JavaScript
阿里云百炼CLI(Bailian CLI)赋能AI Agent:从安装到图像/视频/语音能力全流程指南
阿里云百炼CLI(Bailian CLI)是专为AI Agent场景打造的命令行工具,它将百炼平台的文本、图像、视频、语音、视觉理解、联网搜索、知识库检索等十余项原子能力统一封装,以轻量化、可脚本化的方式对外提供调用入口。通过百炼CLI,各类AI Agent(如Cursor、OpenClaw、Claude Code、Qoder等)无需复杂的接口开发与协议适配,即可一键接入百炼全栈AI能力,实现从单纯文本对话到多模态智能体的能力跃迁。本文将从安装配置、鉴权设置、主流AI Agent接入、图像/视频/语音等核心能力调用、常见问题排查等方面,提供完整实操教程,帮助开发者快速完成集成与能力调用。
696 8