Files
n8n-docs/docs/data/expression-reference/object.md
Kartik Balasubramanian 96e6ba167d Revamp the data section of n8n docs (#4077)
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
2026-02-25 14:30:33 +00:00

5.8 KiB
Raw Permalink Blame History

Object

Object.compact()

Description: Removes all fields that have empty values, i.e. are null or ""

Syntax: Object.compact()

Returns: Object

Source: Custom n8n functionality

Examples:

// obj = {'x':null, 'y':2, 'z':''}
obj.compact() //=> {'y':2}

Object.hasField()

Description: Returns true if there is a field called name. Only checks top-level keys. Comparison is case-sensitive.

Syntax: Object.hasField(name)

Returns: Boolean

Source: Custom n8n functionality

Parameters:

  • name (String) - The name of the key to search for

Examples:

// obj = {'name':'Nathan', 'age':42}
obj.hasField('name') //=> true
// obj = {'name':'Nathan', 'age':42}
obj.hasField('Name') //=> false
obj.hasField('inventedField') //=> false

Object.isEmpty()

Description: Returns true if the Object has no keys (fields) set or is null

Syntax: Object.isEmpty()

Returns: Boolean

Source: Custom n8n functionality

Examples:

// obj = {'name': 'Nathan'}
obj.isEmpty() //=> false
// obj = {}
obj.isEmpty() //=> true

Object.isNotEmpty()

Description: Returns true if the Object has at least one key (field) set

Syntax: Object.isNotEmpty()

Returns: Boolean

Source: Custom n8n functionality

Examples:

// obj = {'name': 'Nathan'}
obj.isNotEmpty() //=> true
// obj = {}
obj.isNotEmpty() //=> false

Object.keepFieldsContaining()

Description: Removes any fields whose values dont at least partly match the given value. Comparison is case-sensitive. Fields that arent strings will always be removed.

Syntax: Object.keepFieldsContaining(value)

Returns: Object

Source: Custom n8n functionality

Parameters:

  • value (String) - The text that a value must contain in order to be kept

Examples:

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

Object.keys()

Description: Returns an array with all the field names (keys) the object contains. The same as JavaScripts Object.keys(obj).

Syntax: Object.keys()

Returns: Array

Source: Custom n8n functionality

Examples:

// obj = {'name': 'Mr Nathan', age: 42 }
obj.keys() //=> ['name', 'age']

Object.merge()

Description: Merges the two Objects into a single one. If a key (field name) exists in both Objects, the value from the first (base) Object is used.

Syntax: Object.merge(otherObject)

Returns: Object

Source: Custom n8n functionality

Parameters:

  • otherObject (Object) - The Object to merge with the base Object.

Examples:

// obj1 = {'name':'Nathan', 'age': 42}
// obj2 = {'name':'Jan', 'city': 'hanoi'}
obj1.merge(obj2) //=> {'name':'Jan', 'city': 'hanoi', 'age':42}

Object.removeField()

Description: Removes a field from the Object. The same as JavaScripts delete.

Syntax: Object.removeField(key)

Returns: Object

Source: Custom n8n functionality

Parameters:

  • key (String) - The name of the field to remove

Examples:

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

Object.removeFieldsContaining()

Description: Removes keys (fields) whose values at least partly match the given value. Comparison is case-sensitive. Fields that arent strings are always kept.

Syntax: Object.removeFieldsContaining(value)

Returns: Object

Source: Custom n8n functionality

Parameters:

  • value (String) - The text that a value must contain in order to be removed

Examples:

// obj = {'name': 'Mr Nathan', 'city':'hanoi', age: 42}
obj.removeFieldsContaining('Nathan') //=> {'city':'hanoi', age: 42}
// obj = {'name': 'Mr Nathan', 'city':'hanoi', age: 42}
obj.removeFieldsContaining('han') //=> {age: 42}
obj.removeFieldsContaining('nathan') //=> {'name': 'Mr Nathan', 'city':'hanoi', age: 42}

Object.toJsonString()

Description: Converts the Object to a JSON string. Similar to JavaScripts JSON.stringify().

Syntax: Object.toJsonString()

Returns: String

Source: Custom n8n functionality

Examples:

// obj = {'name':'Nathan', age:42}
obj.toJsonString() //=> '{"name":"Nathan","age":42}'

Object.urlEncode()

Description: Generates a URL parameter string from the Objects keys and values. Only top-level keys are supported.

Syntax: Object.urlEncode()

Returns: String

Source: Custom n8n functionality

Examples:

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

Object.values()

Description: Returns an array with all the values of the fields the Object contains. The same as JavaScripts Object.values(obj).

Syntax: Object.values()

Returns: Array

Source: Custom n8n functionality

Examples:

// obj = {'name': 'Mr Nathan', age: 42 }
obj.values() //=> ['Mr Nathan', 42]