如何在Palantir Foundry本体编辑函数中更新数组属性

算力阿峰

2026-8-28

问题根因

使用本体函数（FoO）时触发Property 'push' does not exist on type 'readonly string[]'报错，是因为自动生成的类型将数组属性标记为ReadonlyArray<string> | undefined：TS的只读数组类型禁止调用push/splice/pop等所有原地修改数组的方法，从类型层面强制不可变更新逻辑，避免原地改值导致的状态响应失效问题。

正确更新方式

方案1：不可变更新（推荐，全场景兼容）

这是所有状态类场景的标准写法，不修改原数组引用，而是创建新数组赋值给目标属性，同时自动兼容属性为undefined的边界情况：

// 示例：新增元素
// 假设操作对象为fooObj，目标数组属性名为tags
const originalValue = fooObj.tags ?? []
fooObj.tags = [...originalValue, "新增的字符串值"]

其他数组操作都遵循「生成新数组再赋值」的逻辑即可：

// 删除元素：过滤掉符合条件的项
fooObj.tags = (fooObj.tags ?? []).filter(item => item !== "要删除的值")

// 修改元素：遍历替换对应项
fooObj.tags = (fooObj.tags ?? []).map((item, index) => 
  index === 0 ? "修改后的值" : item
)

这种写法完全符合TS类型约束，也能保证所有依赖该属性的逻辑正确触发更新，没有运行时风险。

方案2：类型断言绕过检查（仅特殊场景使用）

如果你确认当前FoO的运行时逻辑支持原地修改数组、不需要靠引用变更触发更新，可以通过类型断言把只读数组转为普通可变数组再操作，注意必须先处理undefined的边界：

// 将只读数组断言为可变数组
const mutableTags = fooObj.tags as string[] | undefined
if (!mutableTags) {
  // 属性不存在时先初始化数组
  fooObj.tags = ["新增的字符串值"]
} else {
  mutableTags.push("新增的字符串值")
}