Tips and tricks #3: How to make calculator with custom errors
This article describes the process of adding custom errors to the calculator
Tips and tricks series
- Tips and tricks #1: How to set output value
- Tips and tricks #2: How to make calculator translatable into different languages
- Tips and tricks #3: How to make calculator with custom errors
- Tips and tricks #4: How to make calculator with table output
- Tips and tricks #5: How to show/hide input and output controls in a calculator
- Tips and tricks #6: How to make calculator with virtual keyboard
- Tips and tricks #7: How to make calculator with SVG image map
- Tips and tricks #8: How to reuse existing calculator
- Tips and tricks #9: Big numbers
- Tips and tricks #10: Files, long calculation mode
- Tips and tricks #11: Dynamic table columns
- Tips and tricks #12: Long (infinite) calculations
- Tips and tricks #13: Bitmaps and Pixel manipulation
- Tips and tricks #14: How to use a masked input
This article may rely on knowledge you should get from previous articles, so you may want to check them first.
Hello, world! Now with custom errors
If you look at different input controls available in the calculator editor, you will find that some of them support validation logic. For example, for number type of input you can specify whether it allows decimal digits, negative numbers, or limit accepted range by ticking Number range checkbox and filling min and max values. If the user violates validation rules, he will see an error message, for example, "Positive integer expected".
But, of course, there could be more complicated cases when you want to provide custom validation logic as well as custom error messages. Here is how to do it.
Let's suppose that in our "Hello, world" calculator we will welcome anybody, except Cthulhu (cause we are expecting that in his house at R'lyeh, dead Cthulhu waits to dream).
Open calculator created in previous articles in calculator editor. Since now we know about localization, we will add our custom error message as another string into resources input. Click on resources link in Calculate function signature to open input editor.
In input editor, fill fields under List items like this:
Field name | Value | Meaning |
---|---|---|
Value | unexpectedcthulhu | Identificator of our error message |
Display name | We are expecting that in his house at R'lyeh, dead Cthulhu waits to dream | Our custom error message |
Press Add then press OK to close the dialog.
Replace current code with the following:
if (username.toLowerCase() == "cthulhu") {
message.SetValue("");
throw {"source":"username", "message":resources["unexpectedcthulhu"]}
}
message.SetValue(resources.hello.replace('%username%', username));
Let's examine it line by line
- Check the input value for "cthulhu"
- Set output control value to an empty string. Otherwise, it would retain previous value, in our case Hello, John
- Inform framework about error using exceptions. Note that both fields are required. source should be set to string literal with input control id, it is used to determine the location of error message on the form, and message is the custom error message
- Closing bracket
- Old code showing Hello, username message
Click on the Preview button. Try to enter "Cthulhu" in Enter your name field - you should receive custom error message. If everything is working as expected, Publish the calculator. I embed it in this article below.
Comentarios