iOS NSError詳解

一、NSError是系統(tǒng)錯(cuò)誤信息類

兩種初始化方法：其中，domain 不能為空 dict可以為空

- (instancetype)initWithDomain:(NSErrorDomain)domain code:(NSInteger)code userInfo:(nullable NSDictionary *)dict;
+ (instancetype)errorWithDomain:(NSErrorDomain)domain code:(NSInteger)code userInfo:(nullable NSDictionary *)dict;
@property (readonly, copy) NSErrorDomain domain;//錯(cuò)誤域

錯(cuò)誤域主要有四個(gè)，對于Carbon框架的Error，歸于OSStatus domain（NSOSStatusErrorDomain），對于POSIX error，歸于NSPOSIXErrorDomain，而對于我們的iOS開發(fā)，一般使用NSCocoaErrorDomain。NSError.h定義了四個(gè)domain

{
// Predefined domain for errors from most AppKit and Foundation APIs.
FOUNDATION_EXPORT NSErrorDomain const NSCocoaErrorDomain;
// Other predefined domains; value of "code" will correspond to preexisting values in these domains.
FOUNDATION_EXPORT NSErrorDomain const NSPOSIXErrorDomain;
FOUNDATION_EXPORT NSErrorDomain const NSOSStatusErrorDomain;
FOUNDATION_EXPORT NSErrorDomain const NSMachErrorDomain;
}
@property (readonly) NSInteger code;//錯(cuò)誤代碼
@property (readonly, copy) NSDictionary *userInfo;//錯(cuò)誤信息
@property (readonly, copy) NSString *localizedDescription;//獲取本地化描述
@property (nullable, readonly, copy) NSString *localizedFailureReason;//獲取失敗原因
@property (nullable, readonly, copy) NSString *localizedRecoverySuggestion;//獲取恢復(fù)建議
@property (nullable, readonly, copy) NSArray<NSString *> *localizedRecoveryOptions;本地恢復(fù)建議
@property (nullable, readonly, strong) id recoveryAttempter;
@property (nullable, readonly, copy) NSString *helpAnchor;

預(yù)定義的userinfo鍵名

 NSString *const NSUnderlyingErrorKey;//推薦的標(biāo)準(zhǔn)方式，通用鍵
 NSString *const NSLocalizedDescriptionKey;             // 詳細(xì)描述鍵
 NSString *const NSLocalizedFailureReasonErrorKey;      // 失敗原因鍵
 NSString *const NSLocalizedRecoverySuggestionErrorKey; //恢復(fù)建議鍵
 NSString *const NSLocalizedRecoveryOptionsErrorKey;    // 恢復(fù)選項(xiàng)鍵

其他鍵

 NSString *const NSRecoveryAttempterErrorKey;    
 NSString *const NSHelpAnchorErrorKey;              
 NSString *const NSStringEncodingErrorKey ;  
 NSString *const NSURLErrorKey;       
 NSString *const NSFilePathErrorKey;

用法示例：

NSDictionary *userInfo1 = [NSDictionary dictionaryWithObjectsAndKeys:@"由于文件不存在，無法打開", NSLocalizedDescriptionKey, @"失敗原因：文件不存在", NSLocalizedFailureReasonErrorKey, @"恢復(fù)建議：請創(chuàng)建該文件",NSLocalizedRecoverySuggestionErrorKey,nil];
    
NSError *error = [[NSError alloc] initWithDomain:NSCocoaErrorDomain code:4 userInfo:userInfo1];//此處code是4，對照下面對照表4代表文件不存在。userinfo傳userinfo1 查看自定義打印。userinfo傳nil，查看本地化描述。
    
NSLog(@"========%@",[error localizedDescription]);
NSLog(@"========%@",[error localizedFailureReason]);
NSLog(@"========%@",[error localizedRecoverySuggestion]);

二、NSError錯(cuò)誤code對照表

Foundation Constants Reference
NSError codes in the Cocoa error domain.

enum {
    NSFileNoSuchFileError = 4,
    NSFileLockingError = 255,
    NSFileReadUnknownError = 256,
    NSFileReadNoPermissionError = 257,
    NSFileReadInvalidFileNameError = 258,
    NSFileReadCorruptFileError = 259,
    NSFileReadNoSuchFileError = 260,
    NSFileReadInapplicableStringEncodingError = 261,
    NSFileReadUnsupportedSchemeError = 262,
    NSFileReadTooLargeError = 263,
    NSFileReadUnknownStringEncodingError = 264,
    NSFileWriteUnknownError = 512,
    NSFileWriteNoPermissionError = 513,
    NSFileWriteInvalidFileNameError = 514,
    NSFileWriteInapplicableStringEncodingError = 517,
    NSFileWriteUnsupportedSchemeError = 518,
    NSFileWriteOutOfSpaceError = 640,
    NSFileWriteVolumeReadOnlyError = 642m
    NSKeyValueValidationError = 1024,
    NSFormattingError = 2048,
    NSUserCancelledError = 3072,
    
    NSFileErrorMinimum = 0,
    NSFileErrorMaximum = 1023,
    NSValidationErrorMinimum = 1024,
    NSValidationErrorMaximum = 2047,
    NSFormattingErrorMinimum = 2048,
    NSFormattingErrorMaximum = 2559,
    
    NSPropertyListReadCorruptError = 3840,
    NSPropertyListReadUnknownVersionError = 3841,
    NSPropertyListReadStreamError = 3842,
    NSPropertyListWriteStreamError = 3851,
    NSPropertyListErrorMinimum = 3840,
    NSPropertyListErrorMaximum = 4095
    
    NSExecutableErrorMinimum = 3584,
    NSExecutableNotLoadableError = 3584,
    NSExecutableArchitectureMismatchError = 3585,
    NSExecutableRuntimeMismatchError = 3586,
    NSExecutableLoadError = 3587,
    NSExecutableLinkError = 3588,
    NSExecutableErrorMaximum = 3839,    
}

URL Loading System Error Codes
These values are returned as the error code property of an NSError object with the domain “NSURLErrorDomain”.

typedef enum
{
    NSURLErrorUnknown = -1,
    NSURLErrorCancelled = -999,
    NSURLErrorBadURL = -1000,
    NSURLErrorTimedOut = -1001,
    NSURLErrorUnsupportedURL = -1002,
    NSURLErrorCannotFindHost = -1003,
    NSURLErrorCannotConnectToHost = -1004,
    NSURLErrorDataLengthExceedsMaximum = -1103,
    NSURLErrorNetworkConnectionLost = -1005,
    NSURLErrorDNSLookupFailed = -1006,
    NSURLErrorHTTPTooManyRedirects = -1007,
    NSURLErrorResourceUnavailable = -1008,
    NSURLErrorNotConnectedToInternet = -1009,
    NSURLErrorRedirectToNonExistentLocation = -1010,
    NSURLErrorBadServerResponse = -1011,
    NSURLErrorUserCancelledAuthentication = -1012,
    NSURLErrorUserAuthenticationRequired = -1013,
    NSURLErrorZeroByteResource = -1014,
    NSURLErrorCannotDecodeRawData = -1015,
    NSURLErrorCannotDecodeContentData = -1016,
    NSURLErrorCannotParseResponse = -1017,
    NSURLErrorFileDoesNotExist = -1100,
    NSURLErrorFileIsDirectory = -1101,
    NSURLErrorNoPermissionsToReadFile = -1102,
    NSURLErrorSecureConnectionFailed = -1200,
    NSURLErrorServerCertificateHasBadDate = -1201,
    NSURLErrorServerCertificateUntrusted = -1202,
    NSURLErrorServerCertificateHasUnknownRoot = -1203,
    NSURLErrorServerCertificateNotYetValid = -1204,
    NSURLErrorClientCertificateRejected = -1205,
    NSURLErrorClientCertificateRequired = -1206,
    NSURLErrorCannotLoadFromNetwork = -2000,
    NSURLErrorCannotCreateFile = -3000,
    NSURLErrorCannotOpenFile = -3001,
    NSURLErrorCannotCloseFile = -3002,
    NSURLErrorCannotWriteToFile = -3003,
    NSURLErrorCannotRemoveFile = -3004,
    NSURLErrorCannotMoveFile = -3005,
    NSURLErrorDownloadDecodingFailedMidStream = -3006,
    NSURLErrorDownloadDecodingFailedToComplete = -3007
}

-1（未知的錯(cuò)誤）
-999（請求被取消）
-1000（請求的URL錯(cuò)誤，無法啟動請求）
-1001（請求超時(shí)）
-1002（不支持的URL Scheme）
-1003（URL的host名稱無法解析，即DNS有問題）
-1004（連接host失?。?-1005（連接過程中被中斷）
-1006（同- -1003）
-1007（重定向次數(shù)超過限制）
-1008（無法獲取所請求的資源）
-1009（斷網(wǎng)狀態(tài)）
-1010（重定向到一個(gè)不存在的位置）
-1011（服務(wù)器返回?cái)?shù)據(jù)有誤）
-1012（身份驗(yàn)證請求被用戶取消）
-1013（訪問資源需要身份驗(yàn)證）
-1014（服務(wù)器報(bào)告URL數(shù)據(jù)不為空，卻未返回任何數(shù)據(jù)）
-1015（響應(yīng)數(shù)據(jù)無法解碼為已知內(nèi)容編碼）
-1016（請求數(shù)據(jù)存在未知內(nèi)容編碼）
-1017（響應(yīng)數(shù)據(jù)無法解析）
-1018（漫游時(shí)請求數(shù)據(jù)，但是漫游開關(guān)已關(guān)閉）
-1019（EDGE、GPRS等網(wǎng)絡(luò)不支持電話和流量同時(shí)進(jìn)行，當(dāng)正在通話過程中，請求失敗錯(cuò)誤碼）
-1020（手機(jī)網(wǎng)絡(luò)不允許連接）
-1021（請求的body流被耗盡）
-1100（請求的文件路徑上文件不存在）
-1101（請求的文件只是一個(gè)目錄，而非文件）
-1102（缺少權(quán)限無法讀取文件）
-1103（資源數(shù)據(jù)大小超過最大限制）

// SSL errors
-1200（安全連接失?。?-1201（服務(wù)器證書過期）
-1202（不受信任的根服務(wù)器簽名證書）
-1203（服務(wù)器證書沒有任何根服務(wù)器簽名）
-1204（服務(wù)器證書還未生效）
-1205（服務(wù)器證書被拒絕）
-1206（需要客戶端證書來驗(yàn)證SSL連接）
-2000（請求只能加載緩存中的數(shù)據(jù)，無法加載網(wǎng)絡(luò)數(shù)據(jù)）

// Download and file I/O errors
-3000（下載操作無法創(chuàng)建文件）
-3001（下載操作無法打開文件）
-3002（下載操作無法關(guān)閉文件）
-3003（下載操作無法寫文件）
-3004（下載操作無法刪除文件）
-3005（下載操作無法移動文件）
-3006（下載操作在下載過程中，對編碼文件進(jìn)行解碼時(shí)失?。?-3007（下載操作在下載完成后，對編碼文件進(jìn)行解碼時(shí)失?。?
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

友情鏈接更多精彩內(nèi)容