Object.fromEntries() 将 URLSearchParams 转为字符串键值对对象，不自动类型转换、不处理重复键；需手动用 Number、显式布尔判断、split 数组解析及 getAll() 处理多值。
Object.fromEntries() 可以直接把 URLSearchParams 转成普通对象，但必须注意键值类型和重复键的处理 —— 它不会自动做字符串转数字、布尔或 JSON 解析，也不会合并同名参数。
为什么 Object.fromEntries(new URLSearchParams(query)) 看似简单却常出错
很多开发者以为一行就能搞定，结果发现返回的对象里所有值都是字符串，比如 "id=123&active=true&tags=a,b,c" 变成 { id: "123", active: "true", tags: "a,b,c" }，而业务逻辑往往需要 id 是数字、active 是布尔、tags 是数组。
-
URLSearchParams的.entries()方法只提供原始字符串键值对，不做任何类型推断 - 多个同名参数（如
?tag=a&tag=b）在.entries()中只会返回第一个，丢失后续项 - 空值（
?name=&id=）会被转为"name": ""，而非undefined或null
怎么安全地还原成带类型和结构的业务对象
先用 Object.fromEntries() 拿到基础对象，再按字段做针对性转换。不要试图让一步操作解决所有问题。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 对已知数字字段（如
id,page），用Number()或一元加号：obj.id = +obj.id，并检查isNaN() - 对布尔字段（如
active,is_public），建议显式判断：obj.active = obj.active === "true"（避免"1"、"yes"等歧义值） - 对数组字段（如
tags），需手动拆分：obj.tags = obj.tags?.split(",").map(s => s.trim()) || [] - 对可能为空的字段，可统一后处理：
if (obj.name === "") delete obj.name
遇到重复参数名时，URLSearchParams.getAll() 才是关键
Object.fromEntries() 无法处理多值场景，比如 ?category=tech&category=design —— 它只会取第一个 tech。这时得绕开 .entries()，改用 .getAll() 手动构建。
- 先获取所有键：
Array.from(searchParams.keys()).filter((v, i, a) => a.indexOf(v) === i) - 再对每个键调用
searchParams.getAll(key)，得到字符串数组 - 最后决定如何聚合：保留数组（
{ category: ["tech", "design"] }）、合并为字符串，或只取最后一个 - 示例片段：
const params = new URLSearchParams(location.search); const result = {}; for (const key of params.keys()) { const values = params.getAll(key); result[key] = values.length === 1 ? values[0] : values; }
真正麻烦的不是转换本身，而是你得清楚每个查询参数的语义和预期类型 —— Object.fromEntries() 只负责“解包”，不负责“理解”。漏掉一个 parseInt() 或误把逗号分隔当单值，线上就可能报类型错误或过滤失效。
