FBErrorUtility
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.

A utility class with methods to provide more information for Facebook related errors if you do not want to use the NSError(FBError) category.

Inherits from:NSObject
Declared in:FBErrorUtility.h
Class Methods
errorCategoryForError:

Categorizes the error, if it is Facebook related, to simplify application mitigation behavior

ParameterDescription
error

The error to be categorized.

+ (FBErrorCategory) errorCategoryForError:(NSError *)error;
Discussion:

In general, in response to an error connecting to Facebook, an application should, retry the operation, request permissions, reconnect the application, or prompt the user to take an action. The error category can be used to understand the class of error received from Facebook. For more infomation on this see https://developers.facebook.com/docs/reference/api/errors/

Declared In: FBErrorUtility.h
errorCodeForError:

Retrieves the underlying error code from an FBError that is wrapped within an NSError. Returns NSNotFound if no error code was found.

ParameterDescription
error

The error whose error code should be retrieved.

+ (NSUInteger) errorCodeForError:(NSError *)error;
Declared In: FBErrorUtility.h
errorSubcodeForError:

Retrieves the underlying error subcode from an FBError that is wrapped within an NSError. Returns NSNotFound if no error subcode was found.

ParameterDescription
error

The error whose error subcode should be retrieved.

+ (NSUInteger) errorSubcodeForError:(NSError *)error;
Declared In: FBErrorUtility.h
isTransientError:

YES if given error is transient and may succeed if the initial action is retried as-is. Application may use this information to display a "Retry" button, if user should be notified about this error.

ParameterDescription
error

The error to inspect.

+ (BOOL) isTransientError:(NSError *)error;
Declared In: FBErrorUtility.h
shouldNotifyUserForError:

If YES indicates that a user action is required in order to successfully continue with the facebook operation

ParameterDescription
error

The error to inspect.

+ (BOOL) shouldNotifyUserForError:(NSError *)error;
Discussion:

In general if this returns NO, then the application has a straightforward mitigation, such as retry the operation or request permissions from the user, etc. In some cases it is necessary for the user to take an action before the application continues to attempt a Facebook connection. For more infomation on this see https://developers.facebook.com/docs/reference/api/errors/

Declared In: FBErrorUtility.h
userMessageForError:

A message suitable for display to the user, describing a user action necessary to enable Facebook functionality. Not all Facebook errors yield a message suitable for user display; however in all cases where +shouldNotifyUserForError: returns YES, this method returns a localizable message suitable for display.

ParameterDescription
error

The error to inspect.

+ (NSString *) userMessageForError:(NSError *)error;
Declared In: FBErrorUtility.h
userTitleForError:

A short summary of the error suitable for display to the user. Not all Facebook errors yield a localized message/title suitable for user display; however in all cases when title is available, user should be notified.

ParameterDescription
error

The error to inspect.

+ (NSString *) userTitleForError:(NSError *)error;
Declared In: FBErrorUtility.h