DOMException

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.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Das DOMException-Interface stellt ein ungewöhnliches Ereignis dar (genannt eine Ausnahme), das beim Aufrufen einer Methode oder beim Zugriff auf eine Eigenschaft einer Web-API auftritt. So werden Fehlerbedingungen in Web-APIs beschrieben.

Jede Ausnahme hat einen Namen, der eine kurze "PascalCase"-Zeichenkette ist, die den Fehler oder die ungewöhnliche Bedingung identifiziert.

DOMException ist ein serialisierbares Objekt, so dass es mit structuredClone() geklont oder zwischen Workers mit postMessage() kopiert werden kann.

Konstruktor

DOMException(): Gibt ein DOMException-Objekt mit einer angegebenen Nachricht und einem Namen zurück.

Instanz-Eigenschaften

DOMException.code Veraltet Nur lesbar: Gibt einen der veralteten Fehlercodekonstanten oder 0 zurück, wenn keiner übereinstimmt.
DOMException.message Nur lesbar: Gibt eine Zeichenkette zurück, die eine Nachricht oder Beschreibung enthält, die mit dem angegebenen Fehlernamen verbunden ist.
DOMException.name Nur lesbar: Gibt eine Zeichenkette zurück, die einen der mit einem Fehlernamen verbundenen Zeichenketten enthält.

Fehlernamen

Häufige Fehlernamen sind hier aufgelistet. Einige APIs definieren ihre eigenen Namenssätze, daher ist dies möglicherweise keine vollständige Liste.

Beachten Sie, dass die folgenden veralteten historischen Fehler keinen Fehlernamen haben, sondern stattdessen nur einen veralteten konstanten Codewert und einen veralteten konstanten Namen:

Veralteter Codewert: 2, veralteter konstanter Name: DOMSTRING_SIZE_ERR
Veralteter Codewert: 6, veralteter konstanter Name: NO_DATA_ALLOWED_ERR
Veralteter Codewert: 16, veralteter konstanter Name: VALIDATION_ERR

Hinweis: Da historisch gesehen die Fehler durch einen numerischen Wert identifiziert wurden, der mit einer benannten Variablen übereinstimmte, die diesen Wert hatte, geben einige der folgenden Einträge den veralteten Codewert und den konstanten Namen an, die in der Vergangenheit verwendet wurden.

IndexSizeError: Der Index liegt nicht im erlaubten Bereich. Zum Beispiel kann dies vom Range-Objekt ausgelöst werden. (Veralteter Codewert: 1 und veralteter konstanter Name: INDEX_SIZE_ERR)
HierarchyRequestError: Die Knotenhierarchie ist nicht korrekt. (Veralteter Codewert: 3 und veralteter konstanter Name: HIERARCHY_REQUEST_ERR)
WrongDocumentError: Das Objekt befindet sich im falschen Document. (Veralteter Codewert: 4 und veralteter konstanter Name: WRONG_DOCUMENT_ERR)
InvalidCharacterError: Die Zeichenkette enthält ungültige Zeichen. (Veralteter Codewert: 5 und veralteter konstanter Name: INVALID_CHARACTER_ERR)
NoModificationAllowedError: Das Objekt kann nicht modifiziert werden. (Veralteter Codewert: 7 und veralteter konstanter Name: NO_MODIFICATION_ALLOWED_ERR)
NotFoundError: Das Objekt kann hier nicht gefunden werden. (Veralteter Codewert: 8 und veralteter konstanter Name: NOT_FOUND_ERR)
NotSupportedError: Die Operation wird nicht unterstützt. (Veralteter Codewert: 9 und veralteter konstanter Name: NOT_SUPPORTED_ERR)
InvalidStateError: Das Objekt befindet sich in einem ungültigen Zustand. (Veralteter Codewert: 11 und veralteter konstanter Name: INVALID_STATE_ERR)
InUseAttributeError: Das Attribut ist in Gebrauch. (Veralteter Codewert: 10 und veralteter konstanter Name: INUSE_ATTRIBUTE_ERR)
SyntaxError: Die Zeichenkette entsprach nicht dem erwarteten Muster. (Veralteter Codewert: 12 und veralteter konstanter Name: SYNTAX_ERR)
InvalidModificationError: Das Objekt kann auf diese Weise nicht modifiziert werden. (Veralteter Codewert: 13 und veralteter konstanter Name: INVALID_MODIFICATION_ERR)
NamespaceError: Die Operation ist durch Namespaces in XML nicht erlaubt. (Veralteter Codewert: 14 und veralteter konstanter Name: NAMESPACE_ERR)
InvalidAccessError: Das Objekt unterstützt die Operation oder das Argument nicht. (Veralteter Codewert: 15 und veralteter konstanter Name: INVALID_ACCESS_ERR)
TypeMismatchError Veraltet: Der Typ des Objekts stimmt nicht mit dem erwarteten Typ überein. (Veralteter Codewert: 17 und veralteter konstanter Name: TYPE_MISMATCH_ERR). Dieser Wert ist veraltet; die JavaScript TypeError-Ausnahme wird jetzt anstelle einer DOMException mit diesem Wert ausgelöst.
SecurityError: Die Operation ist unsicher. (Veralteter Codewert: 18 und veralteter konstanter Name: SECURITY_ERR)
NetworkError Experimentell: Ein Netzwerkfehler ist aufgetreten. (Veralteter Codewert: 19 und veralteter konstanter Name: NETWORK_ERR)
AbortError Experimentell: Die Operation wurde abgebrochen. (Veralteter Codewert: 20 und veralteter konstanter Name: ABORT_ERR)
URLMismatchError Experimentell: Die angegebene URL stimmt nicht mit einer anderen URL überein. (Veralteter Codewert: 21 und veralteter konstanter Name: URL_MISMATCH_ERR)
QuotaExceededError Experimentell: Das Kontingent wurde überschritten. (Veralteter Codewert: 22 und veralteter konstanter Name: QUOTA_EXCEEDED_ERR)
TimeoutError: Die Operation hat das Zeitlimit überschritten. (Veralteter Codewert: 23 und veralteter konstanter Name: TIMEOUT_ERR)
InvalidNodeTypeError Experimentell: Der Knoten ist für diese Operation falsch oder hat einen falschen Vorfahren. (Veralteter Codewert: 24 und veralteter konstanter Name: INVALID_NODE_TYPE_ERR)
DataCloneError Experimentell: Das Objekt kann nicht geklont werden. (Veralteter Codewert: 25 und veralteter konstanter Name: DATA_CLONE_ERR)
EncodingError Experimentell: Die Kodierungs- oder Dekodierungsoperation ist fehlgeschlagen (Kein veralteter Codewert und konstanter Name).
NotReadableError Experimentell: Die Eingabe-/Ausleseoperation ist fehlgeschlagen (Kein veralteter Codewert und konstanter Name).
UnknownError Experimentell: Die Operation ist aus einem unbekannten vorübergehenden Grund fehlgeschlagen (z.B. nicht genügend Speicher) (Kein veralteter Codewert und konstanter Name).
ConstraintError Experimentell: Eine Mutation innerhalb einer Transaktion ist fehlgeschlagen, da eine Bedingung nicht erfüllt wurde (Kein veralteter Codewert und konstanter Name).
DataError Experimentell: Die bereitgestellten Daten sind unzureichend (Kein veralteter Codewert und konstanter Name).
TransactionInactiveError Experimentell: Eine Anforderung wurde gegen eine Transaktion gestellt, die derzeit nicht aktiv oder abgeschlossen ist (Kein veralteter Codewert und konstanter Name).
ReadOnlyError Experimentell: Der Versuch, eine mutierende Operation in einer "readonly"-Transaktion auszuführen (Kein veralteter Codewert und konstanter Name).
VersionError Experimentell: Es wurde versucht, eine Datenbank mit einer niedrigeren Version als der bestehenden Version zu öffnen (Kein veralteter Codewert und konstanter Name).
OperationError Experimentell: Die Operation ist aus einem aufgabenbezogenen Grund fehlgeschlagen (Kein veralteter Codewert und konstanter Name).
NotAllowedError: Die Anfrage ist im aktuellen Kontext möglicherweise nicht erlaubt, möglicherweise weil der Benutzer die Erlaubnis verweigert hat (Kein veralteter Codewert und konstanter Name).

Spezifikationen

Specification
Web IDL Standard # idl-DOMException

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Ein Polyfill von DOMException ist in core-js verfügbar
DOMError