JSON
按名称删除 JSON 节点
删除指定 JSON 当前层中的目标名称节点,适用于移除对象字段、撤销标记和清理局部配置项。
命令用途
Json-DeleteByName 对应的实际命令写法是 JSON <标识> DeleteByName,用于按名称删除当前层中的 JSON 节点。
它适合删除对象当前层里的某个字段,不需要继续写完整路径时用起来更直接。
命令名
Json-DeleteByName
调用格式
JSON <标识> DeleteByName <名称>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要处理的 JSON 标识。 |
DeleteByName | 是 | 固定子命令,表示按名称删除当前层节点。 |
名称 | 是 | 要删除的字段名称。 |
返回或影响
- 该命令会从当前层中删除指定名称的节点。
- 删除后,这个名称对应的值将不再能通过原路径读取。
- 这条命令更适合处理对象当前层字段,不负责跨层路径删除。
示例
基础用法
#ACT
JSON 奖励配置 DeleteByName rewardName
这段写法会从 奖励配置 当前层删除 rewardName 这个字段。
常见变体
#IF
CheckJson 奖励配置 N expired 0
#ACT
JSON 奖励配置 DeleteByName expired
这类写法适合先确认目标字段存在,再把当前层中的过期标记删掉。
注意事项
Json-DeleteByName只删除当前层名称,不适合直接删除深层路径。- 如果目标节点位于对象内部更深的位置,应改用
Json-DeleteByPath。 - 删除前如果需要先确认字段是否存在,通常可先配合
CheckJson的N判断。
