URIError
object constructorS2C Home « Globals « URIError
In JavaScript you create a range error instance using the constructor URIError
.
Description
Creates a URIError
object when a numeric variable or parameter is outside of its valid range.
Syntax
Signature | Description |
---|---|
anError = new URIError([message]); | In JavaScript you create a range error instance using the constructor URIError . |
Parameters
Parameter | Description |
---|---|
message | An optional description of the error. |
Class Properties
Class Property | Description |
---|---|
prototype | Enables property assignment to objects of type URIError . |
Instance Properties
Instance Property | Description |
---|---|
constructor | Returns a reference to the URIError function that created the prototype. |
name | An error name. |
Class Methods
None.
Instance Methods
None.
Examples
Let's look at some examples of throwing a uri error within our code.
// Throw an error.
try {
throw new URIError();
} catch (e) {
alert('A uri error: ' + e.name);
}
// Throw an error with a message.
try {
throw new URIError('Throwing a uri error.');
} catch (e) {
alert('A uri error with message: ' + e.name + ': ' + e.message);
}
We can also create our own URIError
instances as the example below shows.
// Create our own URIError object.
function ourURIError(message) {
this.name = 'OurURIError';
this.message = message || 'Default Message Used When No Message Passed';
}
// Inherit from the URIError prototype.
ourURIError.prototype = new URIError();
ourURIError.prototype.constructor = ourURIError;
// Throw an error.
try {
throw new ourURIError();
} catch (e) {
alert('Our Error: ' + e.name + ' Message: ' + e.message);
}
// Throw an error and a message.
try {
throw new ourURIError('A Message we have passed');
} catch (e) {
alert('Our Error: ' + e.name + ' Our Message: ' + e.message);
} finally {
alert('A finally statement will always be executed!');
}
Related Tutorials
JavaScript Advanced Tutorials - Lesson 2 - Errors