URIError

The URIError object represents an error when a global URI handling function was used in a wrong way.

URIError is a {{Glossary("serializable object")}}, so it can be cloned with {{DOMxRef("Window.structuredClone", "structuredClone()")}} or copied between Workers using {{domxref("Worker/postMessage()", "postMessage()")}}.

URIError is a subclass of {{jsxref("Error")}}.

Constructor#

• {{jsxref("URIError/URIError", "URIError()")}}
• : Creates a new URIError object.

Instance properties#

Also inherits instance properties from its parent {{jsxref("Error")}}.

These properties are defined on URIError.prototype and shared by all URIError instances.

• {{jsxref("Object/constructor", "URIError.prototype.constructor")}}
• : The constructor function that created the instance object. For URIError instances, the initial value is the {{jsxref("URIError/URIError", "URIError")}} constructor.
• {{jsxref("Error/name", "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 {{jsxref("Error")}}.

Examples#

Catching a 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 a 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#

{{Specifications}}

Browser compatibility#

{{Compat}}

See also#

• {{jsxref("Error")}}
• {{jsxref("decodeURI()")}}
• {{jsxref("decodeURIComponent()")}}
• {{jsxref("encodeURI()")}}
• {{jsxref("encodeURIComponent()")}}