语言基础 / 对象节点

学习目标

用可视化方式表达字符串、数组、对象、集合、日期、JSON 和基础运算。

覆盖范围

• 节点数量：15
• 分类路径：语言基础 / 对象

典型使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

通用注意事项

• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

节点索引

节点	节点 ID	输入/输出	执行方式
读取对象字段	languageBaseObjectGetField	2 / 1	立即继续
读取对象字段或默认值	languageBaseObjectGetFieldWithDefault	3 / 2	立即继续
对象是否有字段	languageBaseObjectHasField	2 / 1	立即继续
复制对象	languageBaseObjectClone	1 / 1	立即继续
合并对象	languageBaseObjectMerge	2 / 1	立即继续
获取对象键值记录	languageBaseObjectEntries	1 / 1	立即继续
获取对象字段名	languageBaseObjectKeys	1 / 1	立即继续
获取对象字段值	languageBaseObjectValues	1 / 1	立即继续
清空对象字段	languageBaseObjectClear	1 / 1	立即继续
设置对象字段	languageBaseObjectSetField	3 / 1	立即继续
移除对象字段	languageBaseObjectRemoveField	2 / 2	立即继续
原地合并对象	languageBaseObjectMergeInPlace	3 / 2	立即继续
原地清空对象字段	languageBaseObjectClearInPlace	2 / 2	立即继续
原地设置对象字段	languageBaseObjectSetFieldInPlace	4 / 2	立即继续
原地移除对象字段	languageBaseObjectRemoveFieldInPlace	3 / 3	立即继续

读取对象字段

读取对象字段：按照字段名，从对象里取出对应的一项内容。 适合读取配置表、临时字典、JSON 解析结果或游戏运行时拼装好的对象数据，例如获取当前等级所需的经验值或读取 NPC 的对话内容。 注意：如果这个字段不存在，节点不会报错，而是返回 undefined，方便你继续做判空或回退处理。

节点信息

字段	值
节点 ID	languageBaseObjectGetField
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把你想读取字段的对象连到这里。这个对象通常来自 JSON、配置、对象变量或其他对象节点的输出。	-	必填
field	字段名	数据	string	字段名 输入你要读取的字段名称，例如 hp、name 或 reward。字段名区分大小写。	输入框 默认值：""	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
value	字段值	数据	any	字段值 返回指定字段当前保存的内容。若字段不存在，则返回 undefined。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

读取对象字段或默认值

读取对象字段或默认值：按字段名从对象中读取一项内容；如果对象为空、字段不存在，或字段值是 undefined，就返回你提供的默认值。 适合读取 JSON、关卡配置、角色状态表中的可选字段，例如没有配置移动速度时使用默认速度。 注意：默认值和输出值会绑定为同一种动态类型。默认值没有连接时，输出仍然可以和任意数据类型继续连接。

节点信息

字段	值
节点 ID	languageBaseObjectGetFieldWithDefault
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把要读取字段的对象连到这里。对象通常来自 JSON、配置表、对象变量或其它对象节点。	-	必填
field	字段名	数据	string	字段名 输入要读取的字段名称，例如 hp、name 或 reward。字段名区分大小写。	输入框 默认值：""	必填
defaultValue	默认值	数据	unknown	默认值 当字段不存在或字段值是 undefined 时，会输出这个备用值。可以直接在引脚里填写，也可以连接其它节点。	会根据已连接内容自动提供选择	可选

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
value	字段值	数据	unknown	字段值 字段存在时输出字段内容；否则输出默认值。	-	可选
hasValue	是否命中	数据	boolean	是否命中 true 表示对象里有这个字段且值不是 undefined；false 表示本次使用了默认值。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

对象是否有字段

对象是否有字段：检查对象里是否存在指定的自有字段。 适合在正式读取前先判断某个配置项、奖励字段或附加参数是否已经准备好。 注意：它只检查对象自己身上的字段，不会去扫描原型链上的继承内容。

节点信息

字段	值
节点 ID	languageBaseObjectHasField
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把要检查的对象连到这里。	-	必填
field	字段名	数据	string	字段名 输入要检查的字段名称。	输入框 默认值：""	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	存在	数据	boolean	检查结果 true 表示对象里确实有这个字段；false 表示没有。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

复制对象

复制对象：复制一份新的对象结果，方便你在后续流程里继续修改，而不影响原对象。 会递归复制普通对象和数组；如果字段里装的是函数、Date、组件实例等特殊对象，则这些特殊值会保持原引用透传。 适用场景：复制配置模板、准备临时修改副本、避免多个分支共用同一份对象引用。

节点信息

字段	值
节点 ID	languageBaseObjectClone
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把要复制的对象连到这里。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	复制结果	数据	object	复制结果 返回一份新的对象副本。普通对象和数组会被递归复制。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

合并对象

合并对象：把第二个对象的字段补到第一个对象上，并返回一份新的合并结果。 若两个对象里存在同名字段，后输入对象会覆盖前输入对象中的旧值。 注意：采用浅合并，只处理顶层字段，不会递归深入嵌套对象内部。

节点信息

字段	值
节点 ID	languageBaseObjectMerge
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
base	基础对象	数据	object	基础对象 这里是保留原有字段的主体对象。	-	必填
patch	补丁对象	数据	object	补丁对象 这里的字段会补充到基础对象中；同名字段会覆盖旧值。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	结果对象	数据	object	结果对象 返回浅合并后的新对象。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

获取对象键值记录

获取对象键值记录：把对象中的每个字段整理成一条带 key 和 value 的记录，再输出为数组。 适合搭配”遍历数组”逐项处理。进入循环后，你可以通过”读取对象字段”获取当前记录的 key 或 value。 说明：每条记录是一个包含 key 和 value 字段的普通对象，直观易懂。

节点信息

字段	值
节点 ID	languageBaseObjectEntries
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把要拆成键值记录数组的对象连到这里。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
entries	键值记录数组	数据	object / array	键值记录数组 每一项都是一个普通对象，固定包含 key 和 value 两个字段。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

获取对象字段名

获取对象字段名：返回对象当前拥有的全部字段名称列表。 适合构建动态菜单、遍历字典、先看清对象结构再决定下一步处理。

节点信息

字段	值
节点 ID	languageBaseObjectKeys
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把要列出字段名的对象连到这里。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
keys	字段名列表	数据	string / array	字段名列表 按对象当前字段顺序返回全部名称，例如 [“hp”, “name”]。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

获取对象字段值

获取对象字段值：返回对象里全部字段对应的值列表。 它的顺序会和”获取对象字段名”保持一致，适合把字典内容交给数组遍历、统计或后续整理节点继续处理。 注意：由于字段值类型可能不同，所以统一使用动态值数组输出。

节点信息

字段	值
节点 ID	languageBaseObjectValues
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把要列出字段值的对象连到这里。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
values	字段值列表	数据	any / array	字段值列表 按字段顺序返回全部值。因为每个字段的类型可能不同，所以这里统一按动态值数组输出。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

清空对象字段

清空对象字段：移除对象中的全部字段，并返回一个新的空对象。 适合在重置临时状态、重新拼装配置或清空旧数据时使用。 注意：它不会直接清掉输入对象本身，而是返回一份新的空对象结果。

节点信息

字段	值
节点 ID	languageBaseObjectClear
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把要清空字段的对象连到这里。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	空对象	数据	object	空对象 返回不包含任何字段的新对象 {}。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

设置对象字段

设置对象字段：把指定字段改成新的值，并返回一个改好后的新对象。 适合在不破坏原对象的前提下，逐步补充配置、覆写游戏运行时状态或拼装临时数据，例如更新玩家属性值或修改关卡中的动态参数。 注意：这个节点不会原地修改输入对象，而是返回一份新的对象结果。

节点信息

字段	值
节点 ID	languageBaseObjectSetField
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把需要修改的原对象连到这里。节点会基于它生成一份新的结果对象。	-	必填
field	字段名	数据	string	字段名 输入要写入的字段名称。若对象里原本没有这个字段，节点会在结果对象中新增它。	输入框 默认值：""	必填
value	新值	数据	any	新值 这里是要写进字段的新内容，可以连接数字、文本、布尔值、数组、对象或其他节点结果。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	结果对象	数据	object	结果对象 返回改好字段后的新对象。输入对象本身不会被直接改写。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

移除对象字段

移除对象字段：把指定字段从对象里删除，并返回一个删好后的新对象。 适合移除临时标记、清理旧配置、或在保存前删掉不再需要的字段。 注意：若字段本来就不存在，节点也不会报错，而是返回原样结果并给出未删除标记。

节点信息

字段	值
节点 ID	languageBaseObjectRemoveField
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
object	对象	数据	object	对象 把要删除字段的对象连到这里。	-	必填
field	字段名	数据	string	字段名 输入要删除的字段名称。	输入框 默认值：""	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
result	结果对象	数据	object	结果对象 返回删除字段后的新对象。	-	可选
removed	已删除	数据	boolean	删除状态 true 表示这次确实删掉了一个现有字段；false 表示原对象里没有这个字段。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

原地合并对象

原地合并对象：把补丁对象中的字段直接写回输入对象本身。 补丁对象里的同名字段会覆盖原对象当前值，适合对共享状态做一次批量更新。 注意：这是浅合并，只处理顶层字段；这是一个副作用节点，会直接修改原对象本身。若其他分支也在使用同一份对象，它们会看到同样的变化；如果你想保留旧内容，请先使用“复制对象”。

节点信息

字段	值
节点 ID	languageBaseObjectMergeInPlace
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口 从这里开始这次原地合并。	-	可选
object	对象	数据	object	对象 这里是要被直接改写的原对象。	-	必填
patch	补丁对象	数据	object	补丁对象 这里的字段会被直接写回原对象；同名字段会覆盖旧值。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	继续执行 合并写回完成后，从这里继续后续执行流。	-	可选
object	对象	数据	object	对象 输出已经被原地浅合并后的同一份对象引用。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

原地清空对象字段

原地清空对象字段：直接移除输入对象本身的全部自有字段。 适合把共享上下文、临时字典或状态对象原地重置为空。 注意：这是一个副作用节点，会直接修改原对象本身。若其他分支也在使用同一份对象，它们会看到同样的变化；如果你想保留旧内容，请先使用“复制对象”。

节点信息

字段	值
节点 ID	languageBaseObjectClearInPlace
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口 从这里开始这次原地清空。	-	可选
object	对象	数据	object	对象 把要直接清空字段的原对象连到这里。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	继续执行 对象清空完成后，从这里继续后续执行流。	-	可选
object	对象	数据	object	对象 输出已经被原地清空后的同一份对象引用。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

原地设置对象字段

原地设置对象字段：直接把新值写进输入对象本身，不再返回独立副本。 适合沿着执行流持续补充游戏运行时状态字典或共享配置对象。 注意：这是一个副作用节点，会直接修改原对象本身。若其他分支也在使用同一份对象，它们会看到同样的变化；如果你想保留旧内容，请先使用”复制对象”。

节点信息

字段	值
节点 ID	languageBaseObjectSetFieldInPlace
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口 从这里开始这次原地写入。执行流走到这里时，节点会先改对象，再继续往后执行。	-	可选
object	对象	数据	object	对象 把要直接改动的原对象连到这里。若它是普通对象，节点会直接修改这份对象。	-	必填
field	字段名	数据	string	字段名 输入要写入或覆盖的字段名称。若原对象里没有这个字段，会直接在原对象上新增。	输入框 默认值：""	必填
value	新值	数据	any	新值 这里是要直接写进原对象字段的新内容，可以连接数字、文本、布尔值、数组、对象或其他节点结果。	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	继续执行 对象改写完成后，从这里继续后续执行流。	-	可选
object	对象	数据	object	对象 输出已经被原地修改后的同一份对象引用，可继续传给下游副作用节点。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。

---

原地移除对象字段

原地移除对象字段：直接从输入对象本身删除指定字段。 适合清理共享状态中的临时标记、移除旧配置字段或重置对象内容。 注意：这是一个副作用节点，会直接修改原对象本身。若其他分支也在使用同一份对象，它们会看到同样的变化；如果你想保留旧内容，请先使用“复制对象”。

节点信息

字段	值
节点 ID	languageBaseObjectRemoveFieldInPlace
分类	语言基础
二级分类	对象
分组	-
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口 从这里开始这次原地删除。	-	可选
object	对象	数据	object	对象 把要直接删除字段的原对象连到这里。	-	必填
field	字段名	数据	string	字段名 输入要从原对象中删除的字段名称。	输入框 默认值：""	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	继续执行 字段删除处理完成后，从这里继续后续执行流。	-	可选
object	对象	数据	object	对象 输出已经处理过的同一份对象引用。若字段不存在，也会继续透传这份对象。	-	可选
removed	已删除	数据	boolean	删除状态 true 表示这次确实删掉了原对象里的一个现有字段；false 表示原对象中没有这个字段。	-	可选

使用场景

• 拼接 UI 文本和提示信息
• 处理数组列表、Map、Set 等集合
• 构造条件表达式和数据转换逻辑

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 动态类型节点会跟随主输入推导类型，连线后要留意下游类型变化。
• 集合类节点常区分元素、数组、映射和集合基数。