DOMException
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Das DOMException Interface stellt ein ungewöhnliches Ereignis (genannt eine Ausnahme) dar, das als Ergebnis des Aufrufs einer Methode oder des Zugreifens auf eine Eigenschaft einer Web-API auftritt. So werden Fehlersituationen in Web-APIs beschrieben.
Jede Ausnahme hat einen Namen, der ein kurzer String im "PascalCase"-Stil ist, der den Fehler oder die ungewöhnliche Situation identifiziert.
DOMException ist ein serialisierbares Objekt, sodass es mit structuredClone() geklont oder zwischen Arbeitern mit postMessage() kopiert werden kann.
Konstruktor
DOMException()-
Gibt ein
DOMException-Objekt mit einer angegebenen Nachricht und einem Namen zurück.
Instanzeigenschaften
DOMException.codeSchreibgeschützt-
Gibt einen der veralteten Fehlercodekonstanten oder
0zurück, wenn keine übereinstimmt. DOMException.messageSchreibgeschützt-
Gibt einen String zurück, der eine Nachricht oder eine Beschreibung enthält, die mit dem gegebenen Fehlernamen verknüpft ist.
DOMException.nameSchreibgeschützt-
Gibt einen String zurück, der eine der mit einem Fehlernamen verknüpften 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.
Die folgenden veralteten historischen Fehler haben keinen Fehlernamen, sondern nur einen veralteten konstanten Codewert und einen 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 einer benannten Variablen entsprach, die diesen Wert hatte, geben einige der Einträge unten den veralteten Codewert und den konstanten Namen an, die in der Vergangenheit verwendet wurden.
IndexSizeError-
Der Index ist nicht im erlaubten Bereich. Beispielsweise kann dies vom
RangeObjekt ausgelöst werden. (Veralteter Codewert:1und veralteter konstanter Name:INDEX_SIZE_ERR) HierarchyRequestError-
Die Knotenhierarchie ist nicht korrekt. (Veralteter Codewert:
3und veralteter konstanter Name:HIERARCHY_REQUEST_ERR) WrongDocumentError-
Das Objekt befindet sich im falschen
Document. (Veralteter Codewert:4und veralteter konstanter Name:WRONG_DOCUMENT_ERR) InvalidCharacterError-
Die Zeichenkette enthält ungültige Zeichen. (Veralteter Codewert:
5und veralteter konstanter Name:INVALID_CHARACTER_ERR) NoModificationAllowedError-
Das Objekt kann nicht modifiziert werden. (Veralteter Codewert:
7und veralteter konstanter Name:NO_MODIFICATION_ALLOWED_ERR) NotFoundError-
Das Objekt kann hier nicht gefunden werden. (Veralteter Codewert:
8und veralteter konstanter Name:NOT_FOUND_ERR) NotSupportedError-
Die Operation wird nicht unterstützt. (Veralteter Codewert:
9und veralteter konstanter Name:NOT_SUPPORTED_ERR) InUseAttributeError-
Das Attribut wird verwendet. (Veralteter Codewert:
10und veralteter konstanter Name:INUSE_ATTRIBUTE_ERR) InvalidStateError-
Das Objekt befindet sich in einem ungültigen Zustand. (Veralteter Codewert:
11und veralteter konstanter Name:INVALID_STATE_ERR) SyntaxError-
Die Zeichenkette entsprach nicht dem erwarteten Muster. (Veralteter Codewert:
12und veralteter konstanter Name:SYNTAX_ERR) InvalidModificationError-
Das Objekt kann auf diese Weise nicht modifiziert werden. (Veralteter Codewert:
13und veralteter konstanter Name:INVALID_MODIFICATION_ERR) NamespaceError-
Die Operation ist durch Namespaces in XML nicht erlaubt. (Veralteter Codewert:
14und veralteter konstanter Name:NAMESPACE_ERR) InvalidAccessError-
Das Objekt unterstützt die Operation oder das Argument nicht. (Veralteter Codewert:
15und veralteter konstanter Name:INVALID_ACCESS_ERR) TypeMismatchError-
Der Typ des Objekts stimmt nicht mit dem erwarteten Typ überein. (Veralteter Codewert:
17und veralteter konstanter Name:TYPE_MISMATCH_ERR) Dieser Wert ist veraltet; die JavaScriptTypeErrorAusnahme wird jetzt anstelle einerDOMExceptionmit diesem Wert ausgelöst. SecurityError-
Die Operation ist unsicher. (Veralteter Codewert:
18und veralteter konstanter Name:SECURITY_ERR) NetworkError-
Ein Netzwerkfehler ist aufgetreten. (Veralteter Codewert:
19und veralteter konstanter Name:NETWORK_ERR) AbortError-
Die Operation wurde abgebrochen. (Veralteter Codewert:
20und veralteter konstanter Name:ABORT_ERR) URLMismatchError-
Die angegebene URL stimmt nicht mit einer anderen URL überein. (Veralteter Codewert:
21und veralteter konstanter Name:URL_MISMATCH_ERR) QuotaExceededError-
Das Kontingent wurde überschritten. (Veralteter Codewert:
22und veralteter konstanter Name:QUOTA_EXCEEDED_ERR) Es handelt sich um ein richtiges Interface, das vonDOMExceptionabgeleitet ist. TimeoutError-
Die Operation hat ein Timeout erreicht. (Veralteter Codewert:
23und veralteter konstanter Name:TIMEOUT_ERR) InvalidNodeTypeError-
Der Knoten ist falsch oder hat einen falschen Vorfahren für diese Operation. (Veralteter Codewert:
24und veralteter konstanter Name:INVALID_NODE_TYPE_ERR) DataCloneError-
Das Objekt kann nicht geklont werden. (Veralteter Codewert:
25und veralteter konstanter Name:DATA_CLONE_ERR) EncodingError-
Die Kodierungs- oder Dekodierungsoperation ist fehlgeschlagen (Kein veralteter Codewert und konstanter Name).
NotReadableError-
Die Ein-/Ausleseoperation ist fehlgeschlagen (Kein veralteter Codewert und konstanter Name).
UnknownError-
Die Operation ist aus einem unbekannten, vorübergehenden Grund fehlgeschlagen (z. B. zu wenig Speicher) (Kein veralteter Codewert und konstanter Name).
ConstraintError-
Eine Mutationsoperation in einer Transaktion ist fehlgeschlagen, weil eine Bedingung nicht erfüllt war (Kein veralteter Codewert und konstanter Name).
DataError-
Die bereitgestellten Daten sind unzureichend (Kein veralteter Codewert und konstanter Name).
TransactionInactiveError-
Eine Anfrage wurde gegen eine Transaktion gestellt, die derzeit nicht aktiv oder abgeschlossen ist (Kein veralteter Codewert und konstanter Name).
ReadOnlyError-
In einer "readonly"-Transaktion wurde versucht, eine Veränderungsoperation durchzuführen (Kein veralteter Codewert und konstanter Name).
VersionError-
Es wurde versucht, eine Datenbank mit einer niedrigeren Version als der vorhandenen Version zu öffnen (Kein veralteter Codewert und konstanter Name).
OperationError-
Die Operation ist aus einem operationsspezifischen Grund fehlgeschlagen (Kein veralteter Codewert und konstanter Name).
NotAllowedError-
Die Anfrage ist im aktuellen Kontext durch den Benutzeragenten oder die Plattform nicht erlaubt, möglicherweise weil der Benutzer die Erlaubnis verweigert hat (Kein veralteter Codewert und konstanter Name).
Spezifikationen
| Spezifikation |
|---|
| Web IDL # idl-DOMException |
Browser-Kompatibilität
Siehe auch
- Ein Polyfill von
DOMExceptionist incore-jsverfügbar DOMError