---
title: CocoaError
framework: foundation
role: symbol
role_heading: Structure
path: foundation/cocoaerror
---

# CocoaError

Describes errors within the Cocoa error domain.

## Declaration

```swift
struct CocoaError
```

## Topics

### Structures

- [CocoaError.Code](foundation/cocoaerror/code.md)

### Instance Properties

- [affectedObjects](foundation/cocoaerror/affectedobjects.md)
- [affectedStores](foundation/cocoaerror/affectedstores.md)
- [filePath](foundation/cocoaerror/filepath.md)
- [isCoderError](foundation/cocoaerror/iscodererror.md)
- [isExecutableError](foundation/cocoaerror/isexecutableerror.md)
- [isFileError](foundation/cocoaerror/isfileerror.md)
- [isFontError](foundation/cocoaerror/isfonterror.md)
- [isFormattingError](foundation/cocoaerror/isformattingerror.md)
- [isPropertyListError](foundation/cocoaerror/ispropertylisterror.md)
- [isServiceError](foundation/cocoaerror/isserviceerror.md)
- [isSharingServiceError](foundation/cocoaerror/issharingserviceerror.md)
- [isTextReadWriteError](foundation/cocoaerror/istextreadwriteerror.md)
- [isUbiquitousFileError](foundation/cocoaerror/isubiquitousfileerror.md)
- [isUserActivityError](foundation/cocoaerror/isuseractivityerror.md)
- [isValidationError](foundation/cocoaerror/isvalidationerror.md)
- [isXPCConnectionError](foundation/cocoaerror/isxpcconnectionerror.md)
- [persistentStoreSaveConflicts](foundation/cocoaerror/persistentstoresaveconflicts-swift.property.md)
- [stringEncoding](foundation/cocoaerror/stringencoding.md)
- [underlying](foundation/cocoaerror/underlying.md)
- [underlyingErrors](foundation/cocoaerror/underlyingerrors.md)
- [url](foundation/cocoaerror/url.md)
- [validationKey](foundation/cocoaerror/validationkey.md)
- [validationObject](foundation/cocoaerror/validationobject.md)
- [validationPredicate](foundation/cocoaerror/validationpredicate.md)
- [validationValue](foundation/cocoaerror/validationvalue.md)

### Type Properties

- [ServiceApplicationLaunchFailedError](foundation/cocoaerror/serviceapplicationlaunchfailederror-4hf03.md)
- [ServiceApplicationNotFoundError](foundation/cocoaerror/serviceapplicationnotfounderror-9j679.md)
- [ServiceInvalidPasteboardDataError](foundation/cocoaerror/serviceinvalidpasteboarddataerror-4tjaw.md)
- [ServiceMalformedServiceDictionaryError](foundation/cocoaerror/servicemalformedservicedictionaryerror-5cpn1.md)
- [ServiceMiscellaneousError](foundation/cocoaerror/servicemiscellaneouserror-3ti3r.md)
- [ServiceRequestTimedOutError](foundation/cocoaerror/servicerequesttimedouterror-7kzoa.md)
- [SharingServiceNotConfiguredError](foundation/cocoaerror/sharingservicenotconfigurederror-5lamn.md)
- [TextReadInapplicableDocumentTypeError](foundation/cocoaerror/textreadinapplicabledocumenttypeerror-9o1dx.md)
- [TextWriteInapplicableDocumentTypeError](foundation/cocoaerror/textwriteinapplicabledocumenttypeerror-4aoa6.md)
- [coderInvalidValue](foundation/cocoaerror/coderinvalidvalue.md)
- [coderReadCorrupt](foundation/cocoaerror/coderreadcorrupt.md)
- [coderReadCorruptError](foundation/cocoaerror/coderreadcorrupterror.md)
- [coderValueNotFound](foundation/cocoaerror/codervaluenotfound.md)
- [coderValueNotFoundError](foundation/cocoaerror/codervaluenotfounderror.md)
- [coreData](foundation/cocoaerror/coredata.md)
- [coreDataError](foundation/cocoaerror/coredataerror.md)
- [entityMigrationPolicy](foundation/cocoaerror/entitymigrationpolicy.md)
- [entityMigrationPolicyError](foundation/cocoaerror/entitymigrationpolicyerror.md)
- [executableArchitectureMismatch](foundation/cocoaerror/executablearchitecturemismatch.md)
- [executableArchitectureMismatchError](foundation/cocoaerror/executablearchitecturemismatcherror.md)
- [executableLink](foundation/cocoaerror/executablelink.md)
- [executableLinkError](foundation/cocoaerror/executablelinkerror.md)
- [executableLoad](foundation/cocoaerror/executableload.md)
- [executableLoadError](foundation/cocoaerror/executableloaderror.md)
- [executableNotLoadable](foundation/cocoaerror/executablenotloadable.md)
- [executableNotLoadableError](foundation/cocoaerror/executablenotloadableerror.md)
- [executableRuntimeMismatch](foundation/cocoaerror/executableruntimemismatch.md)
- [executableRuntimeMismatchError](foundation/cocoaerror/executableruntimemismatcherror.md)
- [externalRecordImport](foundation/cocoaerror/externalrecordimport.md)
- [externalRecordImportError](foundation/cocoaerror/externalrecordimporterror.md)
- [featureUnsupported](foundation/cocoaerror/featureunsupported.md)
- [featureUnsupportedError](foundation/cocoaerror/featureunsupportederror.md)
- [fileLocking](foundation/cocoaerror/filelocking.md)
- [fileLockingError](foundation/cocoaerror/filelockingerror.md)
- [fileManagerUnmountBusy](foundation/cocoaerror/filemanagerunmountbusy.md)
- [fileManagerUnmountBusyError](foundation/cocoaerror/filemanagerunmountbusyerror.md)
- [fileManagerUnmountUnknown](foundation/cocoaerror/filemanagerunmountunknown.md)
- [fileManagerUnmountUnknownError](foundation/cocoaerror/filemanagerunmountunknownerror.md)
- [fileNoSuchFile](foundation/cocoaerror/filenosuchfile.md)
- [fileNoSuchFileError](foundation/cocoaerror/filenosuchfileerror.md)
- [fileReadCorruptFile](foundation/cocoaerror/filereadcorruptfile.md)
- [fileReadCorruptFileError](foundation/cocoaerror/filereadcorruptfileerror.md)
- [fileReadInapplicableStringEncoding](foundation/cocoaerror/filereadinapplicablestringencoding.md)
- [fileReadInapplicableStringEncodingError](foundation/cocoaerror/filereadinapplicablestringencodingerror.md)
- [fileReadInvalidFileName](foundation/cocoaerror/filereadinvalidfilename.md)
- [fileReadInvalidFileNameError](foundation/cocoaerror/filereadinvalidfilenameerror.md)
- [fileReadNoPermission](foundation/cocoaerror/filereadnopermission.md)
- [fileReadNoPermissionError](foundation/cocoaerror/filereadnopermissionerror.md)
- [fileReadNoSuchFile](foundation/cocoaerror/filereadnosuchfile.md)
- [fileReadNoSuchFileError](foundation/cocoaerror/filereadnosuchfileerror.md)
- [fileReadTooLarge](foundation/cocoaerror/filereadtoolarge.md)
- [fileReadTooLargeError](foundation/cocoaerror/filereadtoolargeerror.md)
- [fileReadUnknown](foundation/cocoaerror/filereadunknown.md)
- [fileReadUnknownError](foundation/cocoaerror/filereadunknownerror.md)
- [fileReadUnknownStringEncoding](foundation/cocoaerror/filereadunknownstringencoding.md)
- [fileReadUnknownStringEncodingError](foundation/cocoaerror/filereadunknownstringencodingerror.md)
- [fileReadUnsupportedScheme](foundation/cocoaerror/filereadunsupportedscheme.md)
- [fileReadUnsupportedSchemeError](foundation/cocoaerror/filereadunsupportedschemeerror.md)
- [fileWriteFileExists](foundation/cocoaerror/filewritefileexists.md)
- [fileWriteFileExistsError](foundation/cocoaerror/filewritefileexistserror.md)
- [fileWriteInapplicableStringEncoding](foundation/cocoaerror/filewriteinapplicablestringencoding.md)
- [fileWriteInapplicableStringEncodingError](foundation/cocoaerror/filewriteinapplicablestringencodingerror.md)
- [fileWriteInvalidFileName](foundation/cocoaerror/filewriteinvalidfilename.md)
- [fileWriteInvalidFileNameError](foundation/cocoaerror/filewriteinvalidfilenameerror.md)
- [fileWriteNoPermission](foundation/cocoaerror/filewritenopermission.md)
- [fileWriteNoPermissionError](foundation/cocoaerror/filewritenopermissionerror.md)
- [fileWriteOutOfSpace](foundation/cocoaerror/filewriteoutofspace.md)
- [fileWriteOutOfSpaceError](foundation/cocoaerror/filewriteoutofspaceerror.md)
- [fileWriteUnknown](foundation/cocoaerror/filewriteunknown.md)
- [fileWriteUnknownError](foundation/cocoaerror/filewriteunknownerror.md)
- [fileWriteUnsupportedScheme](foundation/cocoaerror/filewriteunsupportedscheme.md)
- [fileWriteUnsupportedSchemeError](foundation/cocoaerror/filewriteunsupportedschemeerror.md)
- [fileWriteVolumeReadOnly](foundation/cocoaerror/filewritevolumereadonly.md)
- [fileWriteVolumeReadOnlyError](foundation/cocoaerror/filewritevolumereadonlyerror.md)
- [fontAssetDownloadError](foundation/cocoaerror/fontassetdownloaderror.md)
- [formatting](foundation/cocoaerror/formatting.md)
- [formattingError](foundation/cocoaerror/formattingerror.md)
- [inferredMappingModel](foundation/cocoaerror/inferredmappingmodel.md)
- [inferredMappingModelError](foundation/cocoaerror/inferredmappingmodelerror.md)
- [keyValueValidation](foundation/cocoaerror/keyvaluevalidation.md)
- [keyValueValidationError](foundation/cocoaerror/keyvaluevalidationerror.md)
- [managedObjectConstraintMerge](foundation/cocoaerror/managedobjectconstraintmerge.md)
- [managedObjectConstraintMergeError](foundation/cocoaerror/managedobjectconstraintmergeerror.md)
- [managedObjectContextLocking](foundation/cocoaerror/managedobjectcontextlocking.md)
- [managedObjectContextLockingError](foundation/cocoaerror/managedobjectcontextlockingerror.md)
- [managedObjectExternalRelationship](foundation/cocoaerror/managedobjectexternalrelationship.md)
- [managedObjectExternalRelationshipError](foundation/cocoaerror/managedobjectexternalrelationshiperror.md)
- [managedObjectMerge](foundation/cocoaerror/managedobjectmerge.md)
- [managedObjectMergeError](foundation/cocoaerror/managedobjectmergeerror.md)
- [managedObjectReferentialIntegrity](foundation/cocoaerror/managedobjectreferentialintegrity.md)
- [managedObjectReferentialIntegrityError](foundation/cocoaerror/managedobjectreferentialintegrityerror.md)
- [managedObjectValidation](foundation/cocoaerror/managedobjectvalidation.md)
- [managedObjectValidationError](foundation/cocoaerror/managedobjectvalidationerror.md)
- [migration](foundation/cocoaerror/migration.md)
- [migrationCancelled](foundation/cocoaerror/migrationcancelled.md)
- [migrationCancelledError](foundation/cocoaerror/migrationcancellederror.md)
- [migrationError](foundation/cocoaerror/migrationerror.md)
- [migrationManagerDestinationStore](foundation/cocoaerror/migrationmanagerdestinationstore.md)
- [migrationManagerDestinationStoreError](foundation/cocoaerror/migrationmanagerdestinationstoreerror.md)
- [migrationManagerSourceStore](foundation/cocoaerror/migrationmanagersourcestore.md)
- [migrationManagerSourceStoreError](foundation/cocoaerror/migrationmanagersourcestoreerror.md)
- [migrationMissingMappingModel](foundation/cocoaerror/migrationmissingmappingmodel.md)
- [migrationMissingMappingModelError](foundation/cocoaerror/migrationmissingmappingmodelerror.md)
- [migrationMissingSourceModel](foundation/cocoaerror/migrationmissingsourcemodel.md)
- [migrationMissingSourceModelError](foundation/cocoaerror/migrationmissingsourcemodelerror.md)
- [persistentStoreCoordinatorLocking](foundation/cocoaerror/persistentstorecoordinatorlocking.md)
- [persistentStoreCoordinatorLockingError](foundation/cocoaerror/persistentstorecoordinatorlockingerror.md)
- [persistentStoreIncompatibleSchema](foundation/cocoaerror/persistentstoreincompatibleschema.md)
- [persistentStoreIncompatibleSchemaError](foundation/cocoaerror/persistentstoreincompatibleschemaerror.md)
- [persistentStoreIncompatibleVersionHash](foundation/cocoaerror/persistentstoreincompatibleversionhash.md)
- [persistentStoreIncompatibleVersionHashError](foundation/cocoaerror/persistentstoreincompatibleversionhasherror.md)
- [persistentStoreIncompleteSave](foundation/cocoaerror/persistentstoreincompletesave.md)
- [persistentStoreIncompleteSaveError](foundation/cocoaerror/persistentstoreincompletesaveerror.md)
- [persistentStoreInvalidType](foundation/cocoaerror/persistentstoreinvalidtype.md)
- [persistentStoreInvalidTypeError](foundation/cocoaerror/persistentstoreinvalidtypeerror.md)
- [persistentStoreOpen](foundation/cocoaerror/persistentstoreopen.md)
- [persistentStoreOpenError](foundation/cocoaerror/persistentstoreopenerror.md)
- [persistentStoreOperation](foundation/cocoaerror/persistentstoreoperation.md)
- [persistentStoreOperationError](foundation/cocoaerror/persistentstoreoperationerror.md)
- [persistentStoreSave](foundation/cocoaerror/persistentstoresave.md)
- [persistentStoreSaveConflicts](foundation/cocoaerror/persistentstoresaveconflicts-swift.type.property.md)
- [persistentStoreSaveConflictsError](foundation/cocoaerror/persistentstoresaveconflictserror.md)
- [persistentStoreSaveError](foundation/cocoaerror/persistentstoresaveerror.md)
- [persistentStoreTimeout](foundation/cocoaerror/persistentstoretimeout.md)
- [persistentStoreTimeoutError](foundation/cocoaerror/persistentstoretimeouterror.md)
- [persistentStoreTypeMismatch](foundation/cocoaerror/persistentstoretypemismatch.md)
- [persistentStoreTypeMismatchError](foundation/cocoaerror/persistentstoretypemismatcherror.md)
- [persistentStoreUnsupportedRequestType](foundation/cocoaerror/persistentstoreunsupportedrequesttype.md)
- [persistentStoreUnsupportedRequestTypeError](foundation/cocoaerror/persistentstoreunsupportedrequesttypeerror.md)
- [propertyListReadCorrupt](foundation/cocoaerror/propertylistreadcorrupt.md)
- [propertyListReadCorruptError](foundation/cocoaerror/propertylistreadcorrupterror.md)
- [propertyListReadStream](foundation/cocoaerror/propertylistreadstream.md)
- [propertyListReadStreamError](foundation/cocoaerror/propertylistreadstreamerror.md)
- [propertyListReadUnknownVersion](foundation/cocoaerror/propertylistreadunknownversion.md)
- [propertyListReadUnknownVersionError](foundation/cocoaerror/propertylistreadunknownversionerror.md)
- [propertyListWriteInvalid](foundation/cocoaerror/propertylistwriteinvalid.md)
- [propertyListWriteInvalidError](foundation/cocoaerror/propertylistwriteinvaliderror.md)
- [propertyListWriteStream](foundation/cocoaerror/propertylistwritestream.md)
- [propertyListWriteStreamError](foundation/cocoaerror/propertylistwritestreamerror.md)
- [serviceApplicationLaunchFailed](foundation/cocoaerror/serviceapplicationlaunchfailed.md)
- [serviceApplicationLaunchFailedError](foundation/cocoaerror/serviceapplicationlaunchfailederror-44r3b.md)
- [serviceApplicationNotFound](foundation/cocoaerror/serviceapplicationnotfound.md)
- [serviceApplicationNotFoundError](foundation/cocoaerror/serviceapplicationnotfounderror-2vdab.md)
- [serviceInvalidPasteboardData](foundation/cocoaerror/serviceinvalidpasteboarddata.md)
- [serviceInvalidPasteboardDataError](foundation/cocoaerror/serviceinvalidpasteboarddataerror-49mrz.md)
- [serviceMalformedServiceDictionary](foundation/cocoaerror/servicemalformedservicedictionary.md)
- [serviceMalformedServiceDictionaryError](foundation/cocoaerror/servicemalformedservicedictionaryerror-3wvlr.md)
- [serviceMiscellaneous](foundation/cocoaerror/servicemiscellaneous.md)
- [serviceMiscellaneousError](foundation/cocoaerror/servicemiscellaneouserror-18rwt.md)
- [serviceRequestTimedOut](foundation/cocoaerror/servicerequesttimedout.md)
- [serviceRequestTimedOutError](foundation/cocoaerror/servicerequesttimedouterror-30ucb.md)
- [sharingServiceNotConfigured](foundation/cocoaerror/sharingservicenotconfigured.md)
- [sharingServiceNotConfiguredError](foundation/cocoaerror/sharingservicenotconfigurederror-1xm1e.md)
- [sqlite](foundation/cocoaerror/sqlite.md)
- [sqliteError](foundation/cocoaerror/sqliteerror.md)
- [textReadInapplicableDocumentType](foundation/cocoaerror/textreadinapplicabledocumenttype.md)
- [textReadInapplicableDocumentTypeError](foundation/cocoaerror/textreadinapplicabledocumenttypeerror-5hv73.md)
- [textWriteInapplicableDocumentType](foundation/cocoaerror/textwriteinapplicabledocumenttype.md)
- [textWriteInapplicableDocumentTypeError](foundation/cocoaerror/textwriteinapplicabledocumenttypeerror-tfdf.md)
- [ubiquitousFileNotUploadedDueToQuota](foundation/cocoaerror/ubiquitousfilenotuploadedduetoquota.md)
- [ubiquitousFileNotUploadedDueToQuotaError](foundation/cocoaerror/ubiquitousfilenotuploadedduetoquotaerror.md)
- [ubiquitousFileUbiquityServerNotAvailable](foundation/cocoaerror/ubiquitousfileubiquityservernotavailable.md)
- [ubiquitousFileUnavailable](foundation/cocoaerror/ubiquitousfileunavailable.md)
- [ubiquitousFileUnavailableError](foundation/cocoaerror/ubiquitousfileunavailableerror.md)
- [userActivityConnectionUnavailable](foundation/cocoaerror/useractivityconnectionunavailable.md)
- [userActivityConnectionUnavailableError](foundation/cocoaerror/useractivityconnectionunavailableerror.md)
- [userActivityHandoffFailed](foundation/cocoaerror/useractivityhandofffailed.md)
- [userActivityHandoffFailedError](foundation/cocoaerror/useractivityhandofffailederror.md)
- [userActivityHandoffUserInfoTooLarge](foundation/cocoaerror/useractivityhandoffuserinfotoolarge.md)
- [userActivityHandoffUserInfoTooLargeError](foundation/cocoaerror/useractivityhandoffuserinfotoolargeerror.md)
- [userActivityRemoteApplicationTimedOut](foundation/cocoaerror/useractivityremoteapplicationtimedout.md)
- [userActivityRemoteApplicationTimedOutError](foundation/cocoaerror/useractivityremoteapplicationtimedouterror.md)
- [userCancelled](foundation/cocoaerror/usercancelled.md)
- [userCancelledError](foundation/cocoaerror/usercancellederror.md)
- [validationDateTooLate](foundation/cocoaerror/validationdatetoolate.md)
- [validationDateTooLateError](foundation/cocoaerror/validationdatetoolateerror.md)
- [validationDateTooSoon](foundation/cocoaerror/validationdatetoosoon.md)
- [validationDateTooSoonError](foundation/cocoaerror/validationdatetoosoonerror.md)
- [validationInvalidDate](foundation/cocoaerror/validationinvaliddate.md)
- [validationInvalidDateError](foundation/cocoaerror/validationinvaliddateerror.md)
- [validationMissingMandatoryProperty](foundation/cocoaerror/validationmissingmandatoryproperty.md)
- [validationMissingMandatoryPropertyError](foundation/cocoaerror/validationmissingmandatorypropertyerror.md)
- [validationMultipleErrors](foundation/cocoaerror/validationmultipleerrors.md)
- [validationMultipleErrorsError](foundation/cocoaerror/validationmultipleerrorserror.md)
- [validationNumberTooLarge](foundation/cocoaerror/validationnumbertoolarge.md)
- [validationNumberTooLargeError](foundation/cocoaerror/validationnumbertoolargeerror.md)
- [validationNumberTooSmall](foundation/cocoaerror/validationnumbertoosmall.md)
- [validationNumberTooSmallError](foundation/cocoaerror/validationnumbertoosmallerror.md)
- [validationRelationshipDeniedDelete](foundation/cocoaerror/validationrelationshipdenieddelete.md)
- [validationRelationshipDeniedDeleteError](foundation/cocoaerror/validationrelationshipdenieddeleteerror.md)
- [validationRelationshipExceedsMaximumCount](foundation/cocoaerror/validationrelationshipexceedsmaximumcount.md)
- [validationRelationshipExceedsMaximumCountError](foundation/cocoaerror/validationrelationshipexceedsmaximumcounterror.md)
- [validationRelationshipLacksMinimumCount](foundation/cocoaerror/validationrelationshiplacksminimumcount.md)
- [validationRelationshipLacksMinimumCountError](foundation/cocoaerror/validationrelationshiplacksminimumcounterror.md)
- [validationStringPatternMatching](foundation/cocoaerror/validationstringpatternmatching.md)
- [validationStringPatternMatchingError](foundation/cocoaerror/validationstringpatternmatchingerror.md)
- [validationStringTooLong](foundation/cocoaerror/validationstringtoolong.md)
- [validationStringTooLongError](foundation/cocoaerror/validationstringtoolongerror.md)
- [validationStringTooShort](foundation/cocoaerror/validationstringtooshort.md)
- [validationStringTooShortError](foundation/cocoaerror/validationstringtooshorterror.md)
- [xpcConnectionInterrupted](foundation/cocoaerror/xpcconnectioninterrupted.md)
- [xpcConnectionInvalid](foundation/cocoaerror/xpcconnectioninvalid.md)
- [xpcConnectionReplyInvalid](foundation/cocoaerror/xpcconnectionreplyinvalid.md)

### Type Methods

- [error(_:userInfo:url:)](foundation/cocoaerror/error(_:userinfo:url:).md)

## Relationships

### Conforms To

- [CustomNSError](foundation/customnserror.md)
- [Equatable](swift/equatable.md)
- [Error](swift/error.md)
- [Hashable](swift/hashable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Error Codes

- [MachError](foundation/macherror.md)
- [POSIXError](foundation/posixerror.md)
- [NSError Codes](foundation/1448136-nserror-codes.md)
