Show TOC

errorCallback( errorObject ) typeLocate this document in the navigation structure

Callback function that is invoked in case of an error.

Syntax

errorCallback( errorObject )

Parameters
Name Type Description
<errorObject> Object Depending on the origin of the error the object can take several forms.(Unfortunately the error object structure and content is not uniform among the platforms, this will probably change in the future.) Errors originating from the logon plugin have only an 'errorKey' property. The possible values for 'errorKey': ERR_CHANGE_TIMEOUT_FAILED ERR_FORGOT_SSO_PIN ERR_INIT_FAILED ERR_INVALID_ACTION ERR_INVALID_STATE ERR_PASSCODE_REQUIRES_DIGIT ERR_PASSCODE_REQUIRES_LOWER ERR_PASSCODE_REQUIRES_SPECIAL ERR_PASSCODE_REQUIRES_UPPER ERR_PASSCODE_TOO_SHORT ERR_PASSCODE_UNDER_MIN_UNIQUE_CHARS ERR_REGISTRATION_CANCEL ERR_REG_FAILED ERR_REG_FAILED_UNATHORIZED ERR_REG_FAILED_WRONG_SERVER ERR_SETPASSCODE_FAILED ERR_SET_AFARIA_CREDENTIAL_FAILED ERR_SSO_PASSCODE_SET_ERROR ERR_UNKNOWN_SCREEN_ID ERR_UNLOCK_FAILED ERR_USER_CANCELLED ERR_PASSCODE_EXPIRED Errors originating in the logon core (either iOS or Android) have the following properties: 'errorCode', 'errorMessage', and 'errorDomain'. The 'errorCode' is just a number uniquely identifying the error. The 'errorMessage' property is a string with more detailed information of what went wrong. The 'errorDomain' property specifies the domain that the error occurred in. On iOS the 'errorDomain' property of the core errors can take the following values: MAFLogonCoreErrorDomain, MAFSecureStoreManagerErrorDomain, and MAFLogonCoreCDVPluginErrorDomain. In the MAFLogonCoreErrorDomain the following errors are thrown (throwing methods in paren): 3 errMAFLogonErrorCommunicationManagerError (register, update settings, delete, change backend password) 9 errMAFLogonErrorCouldNotDecideCommunicator (register) 11 errMAFLogonErrorOperationNotAllowed (all) 12 errMAFLogonErrorInvalidServerHost (register) 13 errMAFLogonErrorInvalidBackendPassword (changeBackendPassword) 15 errMAFLogonErrorUploadTraceFailed (uploadTrace) 16 errMAFLogonErrorInvalidMCIMSSOPin (setMCIMSSOPin) 18 errMAFLogonErrorCertificateKeyError (register) 19 errMAFLogonErrorCertificateError (register) 20 errMAFLogonErrorAfariaInvalidCredentials (setAfariaCredentialWithUser) In the MAFSecureStoreManagerErrorDomain the following errors are thrown (throwing methods in paren): 0 errMAFSecureStoreManagerErrorUnknown (persist, unlock, changePasscode, delete, getContext) 1 errMAFSecureStoreManagerErrorAlreadyExists (persist) 2 errMAFSecureStoreManagerErrorDataTypeError (unlock, getContext) 3 errMAFSecureStoreManagerErrorDoesNotExist (unlock, persist, getContext) 4 errMAFSecureStoreManagerErrorInvalidArg unlock, (persist, getContext) 5 errMAFSecureStoreManagerErrorInvalidPassword (unlock) 6 errMAFSecureStoreManagerErrorLocked (getContext) 7 errMAFSecureStoreManagerErrorOutOfMemory (persist, unlock, changePasscode, delete, getContext) 8 errMAFSecureStoreManagerErrorPasswordExpired (unlock, getContext) 9 errMAFSecureStoreManagerErrorPasswordRequired (persist, changePasscode) 10 errMAFSecureStoreManagerErrorPasswordRequiresDigit (persist, changePasscode) 11 errMAFSecureStoreManagerErrorPasswordRequiresLower (persist, changePasscode) 12 errMAFSecureStoreManagerErrorPasswordRequiresSpecial (persist, changePasscode) 13 errMAFSecureStoreManagerErrorPasswordRequiresUpper (persist, changePasscode) 14 errMAFSecureStoreManagerErrorPasswordUnderMinLength (persist, changePasscode) 15 errMAFSecureStoreManagerErrorPasswordUnderMinUniqueChars (persist, changePasscode) 16 errMAFSecureStoreManagerErrorDeleted (unlock) In the MAFLogonCoreCDVPluginErrorDomain the following errors are thrown: 1 (init failed) 2 (plugin not initialized) 3 (no input provided) On Android the 'errorDomain' property of the core errors can take the following values: MAFLogonCoreErrorDomain and MAFLogonCoreCDVPluginErrorDomain. There are no logon specific error codes, the 'errorCode' property only wraps the error values from the underlying libraries.