> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/build/work-with-data/transform-data/expression-reference/object.md).
# 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:**
```javascript
// 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:**
```javascript
// obj = {'name':'Nathan', 'age':42}
obj.hasField('name') //=> true
```
```javascript
// 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:**
```javascript
// obj = {'name': 'Nathan'}
obj.isEmpty() //=> false
```
```javascript
// 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:**
```javascript
// obj = {'name': 'Nathan'}
obj.isNotEmpty() //=> true
```
```javascript
// obj = {}
obj.isNotEmpty() //=> false
```
## *`Object`*.**`keepFieldsContaining()`**
**Description:** Removes any fields whose values don’t at least partly match the given `value`. Comparison is case-sensitive. Fields that aren’t 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:**
```javascript
// obj = {'name': 'Mr Nathan', 'city':'hanoi', age: 42 }
obj.keepFieldsContaining('Nathan') //=> {'name': 'Mr Nathan'}
```
```javascript
// 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 JavaScript’s `Object.keys(obj)`.
**Syntax:** *`Object`*.keys()
**Returns:** Array
**Source:** Custom n8n functionality
**Examples:**
```javascript
// 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:**
```javascript
// 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 JavaScript’s `delete`.
**Syntax:** *`Object`*.removeField(key)
**Returns:** Object
**Source:** Custom n8n functionality
**Parameters:**
* `key` (String) - The name of the field to remove
**Examples:**
```javascript
// 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 aren’t 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:**
```javascript
// obj = {'name': 'Mr Nathan', 'city':'hanoi', age: 42}
obj.removeFieldsContaining('Nathan') //=> {'city':'hanoi', age: 42}
```
```javascript
// 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 JavaScript’s `JSON.stringify()`.
**Syntax:** *`Object`*.toJsonString()
**Returns:** String
**Source:** Custom n8n functionality
**Examples:**
```javascript
// obj = {'name':'Nathan', age:42}
obj.toJsonString() //=> '{"name":"Nathan","age":42}'
```
## *`Object`*.**`urlEncode()`**
**Description:** Generates a URL parameter string from the Object’s keys and values. Only top-level keys are supported.
**Syntax:** *`Object`*.urlEncode()
**Returns:** String
**Source:** Custom n8n functionality
**Examples:**
```javascript
// 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 JavaScript’s `Object.values(obj)`.
**Syntax:** *`Object`*.values()
**Returns:** Array
**Source:** Custom n8n functionality
**Examples:**
```javascript
// obj = {'name': 'Mr Nathan', age: 42 }
obj.values() //=> ['Mr Nathan', 42]
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.n8n.io/build/work-with-data/transform-data/expression-reference/object.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.