FBError
This class is no longer available in the most recent version of the SDK.
A more recent version of this class is available. Check out the latest version.
Constants
FacebookNativeApplicationDomain
extern NSString *const FacebookNativeApplicationDomain;
Discussion:

The NSError domain of all errors surfaced by the Facebook SDK that were returned by the Facebook Application

Declared In: FBError.h
FacebookSDKDomain
extern NSString *const FacebookSDKDomain;
Discussion:

The NSError domain of all errors returned by the Facebook SDK.

Declared In: FBError.h
FBErrorAppEventsReasonKey
extern NSString *const FBErrorAppEventsReasonKey;
Discussion:

The key in the userInfo NSDictionary of NSError for errors encountered with FBAppEvents operations (error.code equals FBErrorAppEvents).

Declared In: FBError.h
FBErrorDialogCantBeDisplayed
extern NSString *const FBErrorDialogCantBeDisplayed;
Discussion:

A value that may appear in the NSError userInfo dictionary under the FBErrorDialogReasonKey key. Indicates that a native dialog cannot be displayed for some other reason.

Declared In: FBError.h
FBErrorDialogInvalidForSession
extern NSString *const FBErrorDialogInvalidForSession;
Discussion:

A value that may appear in the NSError userInfo dictionary under the FBErrorDialogReasonKey key. Indicates that a native dialog cannot be displayed because it is not appropriate for the current session.

Declared In: FBError.h
FBErrorDialogInvalidOpenGraphActionParameters
extern NSString *const FBErrorDialogInvalidOpenGraphActionParameters;
Discussion:

A value that may appear in the NSError userInfo ditionary under the FBErrorDialogReasonKey key. Indicates that a native dialog cannot be displayed because the parameters for sharing an Open Graph action were not configured. The parameters must include an 'action', 'actionType', and 'previewPropertyName'.

Declared In: FBError.h
FBErrorDialogInvalidOpenGraphObject
extern NSString *const FBErrorDialogInvalidOpenGraphObject;
Discussion:

A value that may appear in the NSError userInfo ditionary under the FBErrorDialogReasonKey key. Indicates that a native dialog cannot be displayed because an Open Graph object that was passed was not configured correctly. The object must either (a) exist by having an 'id' or 'url' value; or, (b) configured for creation (by setting the 'type' value and provisionedForPost property)

Declared In: FBError.h
FBErrorDialogNotSupported
extern NSString *const FBErrorDialogNotSupported;
Discussion:

A value that may appear in the NSError userInfo dictionary under the FBErrorDialogReasonKey key. Indicates that a native dialog is not supported in the current OS.

Declared In: FBError.h
FBErrorDialogReasonKey
extern NSString *const FBErrorDialogReasonKey;
Discussion:

The key in the userInfo NSDictionary of NSError for errors encountered with FBDialogs operations. (error.code equals FBErrorDialog). If present, the value will be one of the constants prefixed by FBErrorDialog*.

Declared In: FBError.h
FBErrorHTTPStatusCodeKey
extern NSString *const FBErrorHTTPStatusCodeKey;
Discussion:

The key in the userInfo NSDictionary of NSError indicating the HTTP status code of the response (if any).

Declared In: FBError.h
FBErrorInnerErrorKey
extern NSString *const FBErrorInnerErrorKey;
Discussion:

The key in the userInfo NSDictionary of NSError where you can find the inner NSError (if any).

Declared In: FBError.h
FBErrorInnerErrorKey
extern NSString *const FBErrorInnerErrorKey;
Discussion:

The key in the userInfo NSDictionary of NSError where you can find the inner NSError (if any).

Declared In: FBError.h
FBErrorLoginFailedOriginalErrorCode
extern NSString *const FBErrorLoginFailedOriginalErrorCode;
Discussion:

The key in the userInfo NSDictionary of NSError for unsuccessful logins (error.code equals FBErrorLoginFailedOrCancelled). If present, the value indicates an original login error code wrapped by this error. This is only used in the web dialog login flow.

Declared In: FBError.h
FBErrorLoginFailedReason
extern NSString *const FBErrorLoginFailedReason;
Discussion:

The key in the userInfo NSDictionary of NSError for unsuccessful logins (error.code equals FBErrorLoginFailedOrCancelled). If present, the value will be one of the constants prefixed by FBErrorLoginFailedReason*.

Declared In: FBError.h
FBErrorLoginFailedReasonInlineCancelledValue
extern NSString *const FBErrorLoginFailedReasonInlineCancelledValue;
Discussion:

A value that may appear in an NSError userInfo dictionary under the FBErrorLoginFailedReason key for login failures. Indicates the user cancelled a web dialog auth.

Declared In: FBError.h
FBErrorLoginFailedReasonInlineNotCancelledValue
extern NSString *const FBErrorLoginFailedReasonInlineNotCancelledValue;
Discussion:

A value that may appear in an NSError userInfo dictionary under the FBErrorLoginFailedReason key for login failures. Indicates the user did not cancel a web dialog auth.

Declared In: FBError.h
FBErrorLoginFailedReasonOtherError
extern NSString *const FBErrorLoginFailedReasonOtherError;
Discussion:

A value that may appear in an NSError userInfo dictionary under the FBErrorLoginFailedReason key for login failures. Indicates an error condition. You may inspect the rest of userInfo for other data.

Declared In: FBError.h
FBErrorLoginFailedReasonSystemDisallowedWithoutErrorValue
extern NSString *const FBErrorLoginFailedReasonSystemDisallowedWithoutErrorValue;
Discussion:

A value that may appear in an NSError userInfo dictionary under the FBErrorLoginFailedReason key for login failures. Indicates the app's slider in iOS 6 (device Settings -> Privacy -> Facebook {app} ) has been disabled.

Declared In: FBError.h
FBErrorLoginFailedReasonSystemError
extern NSString *const FBErrorLoginFailedReasonSystemError;
Discussion:

A value that may appear in an NSError userInfo dictionary under the FBErrorLoginFailedReason key for login failures. Indicates an error has occurred when requesting Facebook account acccess in iOS 6 that was not FBErrorLoginFailedReasonSystemDisallowedWithoutErrorValue nor a user cancellation.

Declared In: FBError.h
FBErrorLoginFailedReasonUserCancelledSystemValue
extern NSString *const FBErrorLoginFailedReasonUserCancelledSystemValue;
Discussion:

A value that may appear in an NSError userInfo dictionary under the FBErrorLoginFailedReason key for login failures. Indicates the user cancelled an iOS system login.

Declared In: FBError.h
FBErrorLoginFailedReasonUserCancelledValue
extern NSString *const FBErrorLoginFailedReasonUserCancelledValue;
Discussion:

A value that may appear in an NSError userInfo dictionary under the FBErrorLoginFailedReason key for login failures. Indicates the user cancelled a non-iOS 6 SSO (either Safari or Facebook App) login.

Declared In: FBError.h
FBErrorParsedJSONResponseKey
extern NSString *const FBErrorParsedJSONResponseKey;
Discussion:

The key in the userInfo NSDictionary of NSError for the parsed JSON response from the server. In case of a batch, includes the JSON for a single FBRequest.

Declared In: FBError.h
FBErrorReauthorizeFailedReasonSessionClosed
extern NSString *const FBErrorReauthorizeFailedReasonSessionClosed;
Discussion:

A value that may appear in the NSError userInfo dictionary under the FBErrorLoginFailedReason key when requesting new permissions fails. Indicates the request for new permissions has failed because the session was closed.

Declared In: FBError.h
FBErrorReauthorizeFailedReasonUserCancelled
extern NSString *const FBErrorReauthorizeFailedReasonUserCancelled;
Discussion:

A value that may appear in the NSError userInfo dictionary under the FBErrorLoginFailedReason key when requesting new permissions fails. Indicates the request for new permissions has failed because the user cancelled.

Declared In: FBError.h
FBErrorReauthorizeFailedReasonUserCancelledSystem
extern NSString *const FBErrorReauthorizeFailedReasonUserCancelledSystem;
Discussion:

A value that may appear in the NSError userInfo dictionary under the FBErrorLoginFailedReason key when requesting new permissions fails on iOS 6 with the Facebook account. Indicates the request for new permissions has failed because the user cancelled.

Declared In: FBError.h
FBErrorReauthorizeFailedReasonWrongUser
extern NSString *const FBErrorReauthorizeFailedReasonWrongUser;
Discussion:

A value that may appear in the NSError userInfo dictionary under the FBErrorLoginFailedReason key when requesting new permissions fails. Indicates the request for new permissions has failed because the request was for a different user than the original permission set.

Declared In: FBError.h
FBErrorSessionKey
extern NSString *const FBErrorSessionKey;
Discussion:

The key in the userInfo NSDictionary of NSError where you can find the session associated with the error (if any).

Declared In: FBError.h
FBErrorUnprocessedURLKey
extern NSString *const FBErrorUnprocessedURLKey;
Discussion:

The key in the userInfo NSDictionary of NSError that points to the URL that caused an error, in its processing by FBAppCall.

Declared In: FBError.h
FBInvalidOperationException
extern NSString *const FBInvalidOperationException;
Discussion:

This exception is raised by methods in the Facebook SDK to indicate that an attempted operation is invalid

Declared In: FBError.h
Typedefs
FBErrorCategory enum

Indicates the Facebook SDK classification for the error

typedef enum {
FBErrorCategoryInvalid = 0,
FBErrorCategoryRetry = 1,
FBErrorCategoryAuthenticationReopenSession = 2,
FBErrorCategoryPermissions = 3,
FBErrorCategoryServer = 4,
FBErrorCategoryThrottling = 5,
FBErrorCategoryUserCancelled = 6,
FBErrorCategoryFacebookOther = -1,
FBErrorCategoryBadRequest = -2,
} FBErrorCategory;
ConstantDescription
FBErrorCategoryInvalid

Indicates that the error category is invalid and likely represents an error that is unrelated to Facebook or the Facebook SDK

FBErrorCategoryRetry

Indicates that the error may be authentication related but the application should retry the operation. This case may involve user action that must be taken, and so the application should also test the fberrorShouldNotifyUser property and if YES display fberrorUserMessage to the user before retrying.

FBErrorCategoryAuthenticationReopenSession

Indicates that the error is authentication related and the application should reopen the session

FBErrorCategoryPermissions

Indicates that the error is permission related

FBErrorCategoryServer

Indicates that the error implies that the server had an unexpected failure or may be temporarily down

FBErrorCategoryThrottling

Indicates that the error results from the server throttling the client

FBErrorCategoryUserCancelled

Indicates the user cancelled the operation

FBErrorCategoryFacebookOther

Indicates that the error is Facebook-related but is uncategorizable, and likely newer than the current version of the SDK

FBErrorCategoryBadRequest

Indicates that the error is an application error resulting in a bad or malformed request to the server.

Declared In: FBError.h
FBErrorCode

Error codes returned by the Facebook SDK in NSError.

typedef enum FBErrorCode {
FBErrorInvalid = 0,
FBErrorOperationCancelled,
FBErrorLoginFailedOrCancelled,
FBErrorRequestConnectionApi,
FBErrorProtocolMismatch,
FBErrorHTTPError,
FBErrorNonTextMimeTypeReturned,
FBErrorDialog,
FBErrorAppEvents,
FBErrorSystemAPI,
FBErrorPublishInstallResponse,
FBErrorAppActivatedWhilePendingAppCall,
FBErrorUntrustedURL,
FBErrorMalformedURL,
FBErrorSessionReconnectInProgess,
FBErrorOperationDisallowedForRestrictedTreament,
} FBErrorCode;
ConstantDescription
FBErrorInvalid

Like nil for FBErrorCode values, represents an error code that has not been initialized yet.

FBErrorProtocolMismatch

The operation failed because the server returned an unexpected response. You can get this error if you are not using the most recent SDK, or if you set your application's migration settings incorrectly for the version of the SDK you are using.

If this occurs on the current SDK with proper app migration settings, you may need to try changing to one request per batch.

FBErrorAppActivatedWhilePendingAppCall

The application had its applicationDidBecomeActive: method called while waiting on a response from the native Facebook app for a pending FBAppCall.

FBErrorUntrustedURL

The application had its openURL: method called from a source that was not a Facebook app and with a URL that was intended for the AppBridge

FBErrorMalformedURL

The URL passed to FBAppCall, was not able to be parsed

FBErrorSessionReconnectInProgess

The operation failed because the session is currently busy reconnecting.

FBErrorOperationDisallowedForRestrictedTreament

Reserved for future use.

Discussion:

These are valid only in the scope of FacebookSDKDomain.

Declared In: FBError.h
FBNativeApplicationErrorCode

Error codes returned by the Facebook SDK in NSError.

typedef enum FBNativeApplicationErrorCode {
FBAppCallErrorUnknown = 1,
FBAppCallErrorUnsupported = 2,
FBAppCallErrorUnknownMethod = 3,
FBAppCallErrorServiceBusy = 4,
FBShareErrorInvalidParam = 100,
FBShareErrorServer = 102,
FBShareErrorUnknown = 103,
FBShareErrorDenied = 104,
} FBNativeApplicationErrorCode;
Discussion:

These are valid only in the scope of FacebookNativeApplicationDomain.

Declared In: FBError.h