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