vjmap Node.js SDK(单文件)
vjmap.js 是一个单文件 Node SDK。零外部依赖,只用 Node ≥ 18 的内置 fetch / FormData / Blob / crypto。
安装
# 方式 A:直接复制
cp sdk/nodejs/vjmap.js your-project/
# 方式 B:作为本地包引用
cd sdk/nodejs && npm link
# 在你的项目里:npm link vjmap-sdk
快速用法
const { Vjmap, VjmapError, MapOpenWay } = require('./vjmap');
const svc = new Vjmap('http://127.0.0.1:27660/api/v1', '<jwt-token>');
(async () => {
console.log(await svc.heart());
console.log(await svc.version());
console.log(await svc.runStatus());
})();
核心导出
| 名称 | 用途 |
|---|---|
Vjmap |
客户端主类 |
VjmapError |
统一异常,含 status / url / body |
MapOpenWay |
.Memory / .GeomRender |
computeSecretKey(pwd) |
明文密码 → 16 位 secretKey |
fileMd5(pathOrBufferOrStream) |
流式 MD5 |
md5Hex(input) |
工具:一次性 MD5 |
错误处理
try {
await svc.metadata('not_exist', 'v1');
} catch (e) {
if (e instanceof VjmapError) {
console.error(e.status, e.url, e.body);
}
}