W3cubDocs

URIError

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 the URIError 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 Language Specification # sec-native-error-types-used-in-this-standard-urierror

Browser compatibility

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	Deno	Node.js
`URIError`	1	12	1	5	1	18	4	10.1	1	1.0	4.4	1.0	0.10.0
`URIError`	1	12	1	5	1	18	4	10.1	1	1.0	4.4	1.0	0.10.0
`serializable_object`	77	79	103 ["Version 103 serializable properties: `name`, `message`, `cause`, `fileName`, `lineNumber` and `columnNumber`.", "Version 104 also serializes `stack` in the main thread (`window.postMessage()` and `structuredClone()`).", "Version 110 also serializes `stack` in workers (`worker.postMessage()` and `structuredClone()`)."]	64	No	77	103 ["Version 103 serializable properties: `name`, `message`, `cause`, `fileName`, `lineNumber` and `columnNumber`.", "Version 104 also serializes `stack` in the main thread (`window.postMessage()` and `structuredClone()`).", "Version 110 also serializes `stack` in workers (`worker.postMessage()` and `structuredClone()`)."]	55	No	12.0	77	No	No