---
title: objectsByEvaluatingSpecifier
framework: foundation
role: symbol
role_heading: Instance Property
path: foundation/nsscriptobjectspecifier/objectsbyevaluatingspecifier
---

# objectsByEvaluatingSpecifier

Returns the actual object represented by the nested series of object specifiers.

## Declaration

```swift
var objectsByEvaluatingSpecifier: Any? { get }
```

## Return Value

Return Value The actual object represented by the nested series of object specifiers.

## Discussion

Discussion Recursively obtains the next container in a nested series of object specifiers until it reaches the top-level container specifier (which is either an NSWhoseSpecifier or the application object), after which it begins evaluating each object specifier (objectsByEvaluating(withContainers:)) going in the opposite direction (top-level to innermost) as it unwinds from the stack. Returns the actual object represented by the nested series of object specifiers. Returns nil if a container specifier could not be evaluated or if no top-level container specifier could be found. Thus nil can be a valid value or can indicate an error; you can use evaluationErrorNumber to determine if and which error occurred and evaluationError to find the container specifier responsible for the error. In the normal course of command processing, this method is invoked by an NSScriptCommand object’s evaluatedArguments and evaluatedReceivers methods, which take as message receiver the innermost object specifier.

## See Also

### Evaluating an object specifier

- [indicesOfObjectsByEvaluating(withContainer:count:)](foundation/nsscriptobjectspecifier/indicesofobjectsbyevaluating(withcontainer:count:).md)
- [objectsByEvaluating(withContainers:)](foundation/nsscriptobjectspecifier/objectsbyevaluating(withcontainers:).md)