new Error(message, configopt)
Errors contain a required message (either a string or jQuery selection) that is used to describe what went wrong in a process. The error's #recoverable and #warning configurations are used to customize the appearance and functionality of the error interface.
The basic error interface contains a formatted error message as well as two buttons: 'Dismiss' and 'Try again' (i.e., the error is 'recoverable' by default). If the error is not recoverable, the 'Try again' button will not be rendered and the widget that initiated the failed process will be disabled.
If the error is a warning, the error interface will include a 'Dismiss' and a 'Continue' button, which will try the process again.
For an example of error interfaces, please see the OOjs UI documentation on MediaWiki.
Parameters:
Name | Type | Attributes | Description | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
message |
string | jQuery | Description of error |
||||||||||||||||
config |
Object |
<optional> |
Configuration options Properties
|
Methods
getMessage() → {jQuery}
Get error message as DOM nodes.
Returns:
Error message in DOM nodes
- Type
- jQuery
getMessageText() → {string}
Get the error message text.
Returns:
Error message
- Type
- string
isRecoverable() → {boolean}
Check if the error is recoverable.
If the error is recoverable, users are able to try the process again.
Returns:
Error is recoverable
- Type
- boolean
isWarning() → {boolean}
Check if the error is a warning.
If the error is a warning, the error interface will include a 'Dismiss' and a 'Continue' button.
Returns:
Error is warning
- Type
- boolean