对象方法

对象方法用于处理和转换对象数据。

方法列表

compact()

移除所有值为 null 或 undefined 的字段。递归处理嵌套对象。

返回值: Object

示例:

javascript

{{ ({ x: null, y: 2, z: '', w: 'nil', a: {} }).compact() }}
// { y: 2, z: '', w: 'nil', a: {} }

{{ { a: 1, b: null, c: undefined, d: "hello" }.compact() }}
// { "a": 1, "d": "hello" }

{{ { a: 0, b: "", c: [], d: {} }.compact() }}
// { "a": 0, "b": "", "c": [], "d": {} }
// 注意：0、空字符串、空数组、空对象不会被移除

{{ $('HTTP Request').body.user.compact() }}
// 移除用户对象中的 null 和 undefined 值（递归）

hasField(fieldName: String)

如果存在名为 name 的字段，返回 true。仅检查顶层键。比较是大小写敏感的。

参数:

fieldName (String): 要搜索的键名

返回值: Boolean

示例:

javascript

{{ ({ name: 'Nathan', age: 42 }).hasField('name') }}
// true

{{ ({ name: 'Nathan', age: 42 }).hasField('Name') }}
// false

{{ ({ name: 'Nathan', age: 42 }).hasField('inventedField') }}
// false

{{ $('HTTP Request').body.user.hasField('email') }}
// 检查用户对象是否包含邮箱字段

isEmpty()

如果对象没有设置任何键（字段）或是 null，返回 true。

返回值: Boolean

示例:

javascript

{{ ({ name: 'Nathan' }).isEmpty() }}
// false

{{ ({}).isEmpty() }}
// true

{{ { name: 'Alice' }.isEmpty() }}
// false

{{ $('HTTP Request').body.config.isEmpty() }}
// 检查配置对象是否为空

isNotEmpty()

如果对象至少设置了一个键（字段），返回 true。

返回值: Boolean

示例:

javascript

{{ ({ name: 'Nathan' }).isNotEmpty() }}
// true

{{ ({}).isNotEmpty() }}
// false

{{ $('HTTP Request').body.config.isNotEmpty() }}
// 检查配置对象是否有字段

keepFieldsContaining(value: String)

移除值不完全匹配给定 value 的任何字段。比较是大小写敏感的。不是字符串的字段总是被移除。如果参数不是字符串，会抛出错误。

参数:

value (String): 值必须包含的文本才能被保留

返回值: Object

示例:

javascript

{{ ({ name: 'Mr Nathan', city: 'hanoi', age: 42 }).keepFieldsContaining('Nathan') }}
// { name: 'Mr Nathan' }

{{ ({ name: 'Mr Nathan', city: 'hanoi', age: 42 }).keepFieldsContaining('nathan') }}
// {}
// 大小写敏感，所以 'Nathan' 不匹配 'nathan'

{{ ({ name: 'Mr Nathan', city: 'hanoi', age: 42 }).keepFieldsContaining('han') }}
// { name: 'Mr Nathan', city: 'hanoi' }

{{ $('HTTP Request').body.data.keepFieldsContaining("prod") }}
// 只保留生产环境相关的字段

merge(object: Object)

使用当前对象作为基础，将两个对象合并为一个新对象。如果两个对象共享一个键，基础对象的值会被保留。如果参数不是对象或是数组，会抛出错误。

参数:

object (Object): 要合并到基础对象中的对象

返回值: Object

示例:

javascript

// 基础对象的值优先
{{ ({ a: 1, b: 2 }).merge({ b: 3, c: 4 }) }}
// { a: 1, b: 2, c: 4 }

{{ { name: 'Alice', age: 25 }.merge({ age: 30, city: 'Beijing' }) }}
// { "name": "Alice", "age": 25, "city": "Beijing" }

{{ $('HTTP Request').body.user.merge($('Default Config').defaults) }}
// 将默认配置合并到用户数据

removeField(key: String)

从对象中移除一个字段。与 JavaScript 的 delete 相同。如果字段不存在，返回原对象。

参数:

key (String): 要移除的字段名

返回值: Object

示例:

javascript

{{ ({ name: 'Nathan', city: 'hanoi' }).removeField('name') }}
// { city: 'hanoi' }

{{ { name: 'Alice', age: 25, password: '123456' }.removeField('password') }}
// { "name": "Alice", "age": 25 }

{{ $('HTTP Request').body.user.removeField('internalId') }}
// 移除内部 ID 字段

removeFieldsContaining(value: String)

移除值至少部分匹配给定 value 的键（字段）。比较是大小写敏感的。不是字符串的字段总是被保留。如果参数不是字符串，会抛出错误。

参数:

value (String): 值必须包含的文本才能被移除

返回值: Object

示例:

javascript

{{ ({ name: 'Mr Nathan', city: 'hanoi', age: 42 }).removeFieldsContaining('Nathan') }}
// { city: 'hanoi', age: 42 }

{{ ({ name: 'Mr Nathan', city: 'hanoi', age: 42 }).removeFieldsContaining('Han') }}
// { age: 42 }

{{ ({ name: 'Mr Nathan', city: 'hanoi', age: 42 }).removeFieldsContaining('nathan') }}
// { name: 'Mr Nathan', city: 'hanoi', age: 42 }
// 大小写敏感，所以 'Nathan' 不匹配 'nathan'

{{ $('HTTP Request').body.data.removeFieldsContaining("temp") }}
// 移除所有包含 "temp" 的临时字段

toJsonString()

将对象转换为 JSON 字符串。类似于 JavaScript 的 JSON.stringify()。

返回值: String

示例:

javascript

{{ ({ name: 'Mr Nathan', age: 42 }).toJsonString() }}
// '{"name":"Nathan","age":42}'

{{ { name: 'Alice', age: 25 }.toJsonString() }}
// '{"name":"Alice","age":25}'

{{ $('HTTP Request').body.user.toJsonString() }}
// 将用户对象转换为 JSON 字符串

urlEncode()

从对象的键和值生成 URL 参数字符串。仅支持顶层键。

返回值: String

示例:

javascript

{{ ({ name: 'Mr Nathan', city: 'hanoi' }).urlEncode() }}
// 'name=Mr+Nathan&city=hanoi'

{{ { name: 'Alice', age: 25 }.urlEncode() }}
// "name=Alice&age=25"

{{ { q: 'hello world', page: 1 }.urlEncode() }}
// "q=hello+world&page=1"

{{ $('HTTP Request').body.params.urlEncode() }}
// 将参数对象转换为 URL 查询字符串

使用场景

1. 对象合并

javascript

// 合并用户输入和默认配置
{{ $('User Input').config.merge({
  timeout: 30000,
  retries: 3,
  debug: false
}) }}

// 合并多个数据源
{{ $('Source A').data.merge($('Source B').data) }}

2. 字段过滤

javascript

// 移除敏感字段
{{ $('HTTP Request').body.user
  .removeField('password')
  .removeField('token') }}

// 只保留特定字段
{{ $('HTTP Request').body.data.keepFieldsContaining("public") }}

// 移除测试字段
{{ $('HTTP Request').body.data.removeFieldsContaining("test") }}

3. 数据清理

javascript

// 移除空值
{{ $('HTTP Request').body.formData.compact() }}

// 移除不需要的字段
{{ $('HTTP Request').body.user
  .removeField('_id')
  .removeField('__v')
  .compact() }}

4. 数据转换

javascript

// 转换为 JSON 字符串存储
{{ $('HTTP Request').body.config.toJsonString() }}

// 转换为 URL 参数
{{ $('HTTP Request').body.filters.urlEncode() }}

5. 字段验证

javascript

// 检查必需字段
{{ $('HTTP Request').body.user.hasField('email')
  && $('HTTP Request').body.user.hasField('name') }}

// 检查对象是否为空
{{ $('HTTP Request').body.result.isEmpty() }}

// 检查对象是否有字段
{{ $('HTTP Request').body.result.isNotEmpty() }}

链式调用

对象方法可以链式调用：

javascript

// 清理和合并对象
{{ $('HTTP Request').body.user
  .compact()
  .removeField('password')
  .merge({ updatedAt: $now() }) }}

// 过滤和转换
{{ $('HTTP Request').body.config
  .keepFieldsContaining("prod")
  .compact()
  .toJsonString() }}

嵌套对象处理

对象方法主要处理顶层键。对于嵌套对象，建议使用代码节点：

javascript

// 在代码节点中处理嵌套对象
const user = $('HTTP Request').body.user;

// 处理嵌套字段
if (user.profile && user.profile.settings) {
  delete user.profile.settings.internalFlag;
}

return user;

最佳实践

1. 合并对象时注意顺序

javascript

// 基础对象的值优先
{{ $('User Data').config.merge($('Default Config').defaults) }}
// User Data 的值会覆盖 Default Config 的值

2. 使用 compact 移除空值

javascript

// 在发送 API 请求前清理数据
{{ $('HTTP Request').body.params.compact() }}

3. 移除敏感信息

javascript

// 在记录日志前移除敏感字段
{{ $('HTTP Request').body.user
  .removeField('password')
  .removeField('creditCard')
  .removeField('ssn') }}

4. 检查字段存在性

javascript

// 在访问前检查字段是否存在
{{ $('HTTP Request').body.user.hasField('email')
  ? $('HTTP Request').body.user.email
  : 'no-email@example.com' }}

5. 使用 urlEncode 构建查询字符串

javascript

// 构建 API 查询参数
{{ `https://api.example.com/search?${$('HTTP Request').body.filters.urlEncode()}` }}

与其他方法结合

javascript

// 获取对象的键数组
{{ Object.keys($('HTTP Request').body.user) }}

// 获取对象的值数组
{{ Object.values($('HTTP Request').body.prices) }}

// 在代码节点中使用对象方法
const data = $('HTTP Request').body.data;
const cleaned = data.compact().removeField('_internal');
return cleaned;

触发器节点

Chat 触发器

Action 节点

Control 节点

Tool 节点

分组节点

对象方法

方法列表

compact()

hasField(fieldName: String)

isEmpty()

isNotEmpty()

keepFieldsContaining(value: String)

merge(object: Object)

removeField(key: String)

removeFieldsContaining(value: String)

toJsonString()

urlEncode()

使用场景

1. 对象合并

2. 字段过滤

3. 数据清理

4. 数据转换

5. 字段验证

链式调用

嵌套对象处理

最佳实践

1. 合并对象时注意顺序

2. 使用 compact 移除空值

3. 移除敏感信息

4. 检查字段存在性

5. 使用 urlEncode 构建查询字符串

与其他方法结合

相关资源

Chat 触发器

对象方法 ​

方法列表 ​

compact() ​

hasField(fieldName: String) ​

isEmpty() ​

isNotEmpty() ​

keepFieldsContaining(value: String) ​

merge(object: Object) ​

removeField(key: String) ​

removeFieldsContaining(value: String) ​

toJsonString() ​

urlEncode() ​

使用场景 ​

1. 对象合并 ​

2. 字段过滤 ​

3. 数据清理 ​

4. 数据转换 ​

5. 字段验证 ​

链式调用 ​

嵌套对象处理 ​

最佳实践 ​

1. 合并对象时注意顺序 ​

2. 使用 compact 移除空值 ​

3. 移除敏感信息 ​

4. 检查字段存在性 ​

5. 使用 urlEncode 构建查询字符串 ​

与其他方法结合 ​

相关资源 ​

对象方法

方法列表

compact()

hasField(fieldName: String)

isEmpty()

isNotEmpty()

keepFieldsContaining(value: String)

merge(object: Object)

removeField(key: String)

removeFieldsContaining(value: String)

toJsonString()

urlEncode()

使用场景

1. 对象合并

2. 字段过滤

3. 数据清理

4. 数据转换

5. 字段验证

链式调用

嵌套对象处理

最佳实践

1. 合并对象时注意顺序

2. 使用 compact 移除空值

3. 移除敏感信息

4. 检查字段存在性

5. 使用 urlEncode 构建查询字符串

与其他方法结合

相关资源