Errors
======

All errors resulting from operations with the API are represented by a :js:class:`SCWS.Error` object:

.. js:autoclass:: SCWS.Error
.. js:autoattribute:: Error#message
.. js:autoattribute:: Error#code

	In addition, possible values for ICAO specific :js:data:`Error.code` are the following:

	- ``"ICAO_ERR_FILE_NOT_FOUND"``: The file does not exist.
	- ``"ICAO_ERR_INVALID_PARAMS"``: The given parameters are invalid.
	- ``"ICAO_ERR_GENERAL_ERROR"``: An unrecoverable error occurred. This may be due to an inconsistency in the smart card data.
	- ``"ICAO_ERR_OPERATION_NOT_PERMITTED"``: The operation is not permitted by token.
	- ``"ICAO_ERR_SECURITY_STATUS_NOT_SATISFIED"``: The security status for this operation is not satisfied.
	- ``"ICAO_ERR_CREDENTIAL_SUSPENDED"``: The given credential is suspended. Please launch procedure to resume it.
	- ``"ICAO_ERR_CREDENTIAL_DEACTIVATED"``: The given credential is deactivated. Please launch procedure to activate it.
	- ``"ICAO_ERR_CREDENTIAL_BLOCKED"``: The given credential is blocked. Please launch procedure to unblock it.
	- ``"ICAO_ERR_FUNCTION_FAILED"``: The operation failed for some unknown reason. Please try again.
	- ``"ICAO_ERR_FUNCTION_NOT_SUPPORTED"``: The operation is not supported by the token or middleware.
	- ``"ICAO_ERR_AUTHENTICATION_FAILED"``: The authentication failed.
	- ``"ICAO_ERR_VERIFY_CERTIFICATE_FAILED"``: The certificate verification failed.
	- ``"ICAO_ERR_TOKEN_NOT_RECOGNIZED"``: The token is not supported.
	- ``"ICAO_ERR_TOKEN_NOT_PRESENT"``: The token is not present.

.. js:autoattribute:: Error#httpStatus

.. NOTE::
  In this API reference, each **throws** section of a function specifies :js:data:`Error.code`, not error types.