URIError
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
* Some parts of this feature may have varying levels of support.
The URIError
object represents an error when a global URI handling function was used in a wrong way.
URIError
is a serializable object, so it can be cloned with structuredClone()
or copied between Workers using postMessage()
.
URIError
is a subclass of Error
.
Constructor
URIError()
Creates a new
URIError
object.
Instance properties
Also inherits instance properties from its parent Error
.
These properties are defined on URIError.prototype
and shared by all URIError
instances.
URIError.prototype.constructor
The constructor function that created the instance object. For
URIError
instances, the initial value is theURIError
constructor.URIError.prototype.name
Represents the name for the type of error. For
URIError.prototype.name
, the initial value is"URIError"
.
Instance methods
Inherits instance methods from its parent Error
.
Examples
Catching an URIError
try { decodeURIComponent("%"); } catch (e) { console.log(e instanceof URIError); // true console.log(e.message); // "malformed URI sequence" console.log(e.name); // "URIError" console.log(e.stack); // Stack of the error }
Creating an URIError
try { throw new URIError("Hello"); } catch (e) { console.log(e instanceof URIError); // true console.log(e.message); // "Hello" console.log(e.name); // "URIError" console.log(e.stack); // Stack of the error }
Specifications
Specification |
---|
ECMAScript® 2026 Language Specification # sec-native-error-types-used-in-this-standard-urierror |