<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "XCTest",
  "identifier" : "/documentation/XCTest/XCTestCase/expectation(forNotification:object:notificationCenter:handler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "XCTest"
    ],
    "preciseIdentifier" : "c:objc(cs)XCTestCase(im)expectationForNotification:object:notificationCenter:handler:"
  },
  "title" : "expectation(forNotification:object:notificationCenter:handler:)"
}
-->

# expectation(forNotification:object:notificationCenter:handler:)

Creates an expectation that the test fulfills when it receives a specific notification from a specific notification center for a specified object.

```
func expectation(forNotification notificationName: NSNotification.Name, object objectToObserve: Any?, notificationCenter: NotificationCenter, handler: XCTNSNotificationExpectation.Handler? = nil) -> XCTestExpectation
```

## Parameters

`notificationName`

The notification to register for.

`objectToObserve`

The object to observe.

`notificationCenter`

The notification center sending the notification.

`handler`

An optional [`XCTNSNotificationExpectation.Handler`](/documentation/XCTest/XCTNSNotificationExpectation/Handler-swift.typealias) block. If no handler is provided, the first notification matching the specified name from the observed object fulfills the expectation.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)