DOMException
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
* Some parts of this feature may have varying levels of support.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die DOMException-Schnittstelle stellt ein anormales Ereignis (eine Ausnahme) dar, das als Ergebnis eines Aufrufs einer Methode oder des Zugriffs auf eine Eigenschaft einer Web-API auftritt. Auf diese Weise werden Fehlerzustände in Web-APIs beschrieben.
Jede Ausnahme hat einen Namen, der ein kurzer "PascalCase"-String ist, der den Fehler oder die anormale Bedingung identifiziert.
DOMException ist ein serialisierbares Objekt, sodass es mit structuredClone() geklont oder zwischen Workers mithilfe von postMessage() kopiert werden kann.
Konstruktor
DOMException()-
Gibt ein
DOMException-Objekt mit einer angegebenen Nachricht und einem Namen zurück.
Instanz-Eigenschaften
DOMException.codeVeraltet Schreibgeschützt-
Gibt einen der veralteten Fehlercodekonstanten oder
0zurück, wenn keiner übereinstimmt. DOMException.messageSchreibgeschützt-
Gibt einen String zurück, der eine Nachricht oder Beschreibung darstellt, die mit dem angegebenen Fehlernamen verbunden ist.
DOMException.nameSchreibgeschützt-
Gibt einen String zurück, der einen der Strings enthält, die mit einem Fehlernamen verbunden sind.
Fehlernamen
Häufige Fehlernamen sind hier aufgeführt. Einige APIs definieren ihre eigenen Satz von Namen, daher ist dies nicht unbedingt eine vollständige Liste.
Die folgenden veralteten historischen Fehler haben keinen Fehlernamen, sondern nur einen veralteten konstanten Codewert und einen veralteten konstanten Namen:
- Veralteter Code-Wert:
2, veralteter konstanter Name:DOMSTRING_SIZE_ERR - Veralteter Code-Wert:
6, veralteter konstanter Name:NO_DATA_ALLOWED_ERR - Veralteter Code-Wert:
16, veralteter konstanter Name:VALIDATION_ERR
Hinweis: Da die Fehler historisch durch einen numerischen Wert identifiziert wurden, der einer benannten Variablen zugewiesen wurde, die diesen Wert definiert hatte, geben einige der folgenden Einträge den veralteten Codewert und den konstanten Namen an, die in der Vergangenheit verwendet wurden.
IndexSizeError-
Der Index befindet sich nicht im erlaubten Bereich. Zum Beispiel kann dies vom
Range-Objekt ausgelöst werden. (Veralteter Code-Wert:1und veralteter konstanter Name:INDEX_SIZE_ERR) HierarchyRequestError-
Die Knotenhierarchie ist nicht korrekt. (Veralteter Code-Wert:
3und veralteter konstanter Name:HIERARCHY_REQUEST_ERR) WrongDocumentError-
Das Objekt befindet sich im falschen
Document. (Veralteter Code-Wert:4und veralteter konstanter Name:WRONG_DOCUMENT_ERR) InvalidCharacterError-
Der String enthält ungültige Zeichen. (Veralteter Code-Wert:
5und veralteter konstanter Name:INVALID_CHARACTER_ERR) NoModificationAllowedError-
Das Objekt kann nicht geändert werden. (Veralteter Code-Wert:
7und veralteter konstanter Name:NO_MODIFICATION_ALLOWED_ERR) NotFoundError-
Das Objekt kann hier nicht gefunden werden. (Veralteter Code-Wert:
8und veralteter konstanter Name:NOT_FOUND_ERR) NotSupportedError-
Die Operation wird nicht unterstützt. (Veralteter Code-Wert:
9und veralteter konstanter Name:NOT_SUPPORTED_ERR) InUseAttributeError-
Das Attribut ist in Benutzung. (Veralteter Code-Wert:
10und veralteter konstanter Name:INUSE_ATTRIBUTE_ERR) InvalidStateError-
Das Objekt befindet sich in einem ungültigen Zustand. (Veralteter Code-Wert:
11und veralteter konstanter Name:INVALID_STATE_ERR) SyntaxError-
Der String entsprach nicht dem erwarteten Muster. (Veralteter Code-Wert:
12und veralteter konstanter Name:SYNTAX_ERR) InvalidModificationError-
Das Objekt kann auf diese Weise nicht geändert werden. (Veralteter Code-Wert:
13und veralteter konstanter Name:INVALID_MODIFICATION_ERR) NamespaceError-
Die Operation ist durch Namespaces in XML nicht erlaubt. (Veralteter Code-Wert:
14und veralteter konstanter Name:NAMESPACE_ERR) InvalidAccessError-
Das Objekt unterstützt die Operation oder das Argument nicht. (Veralteter Code-Wert:
15und veralteter konstanter Name:INVALID_ACCESS_ERR) TypeMismatchErrorVeraltet-
Der Typ des Objekts stimmt nicht mit dem erwarteten Typ überein. (Veralteter Code-Wert:
17und veralteter konstanter Name:TYPE_MISMATCH_ERR). Dieser Wert ist veraltet; die JavaScriptTypeError-Ausnahme wird jetzt anstelle einerDOMExceptionmit diesem Wert ausgelöst. SecurityError-
Die Operation ist unsicher. (Veralteter Code-Wert:
18und veralteter konstanter Name:SECURITY_ERR) NetworkErrorExperimentell-
Ein Netzwerkfehler ist aufgetreten. (Veralteter Code-Wert:
19und veralteter konstanter Name:NETWORK_ERR) AbortErrorExperimentell-
Die Operation wurde abgebrochen. (Veralteter Code-Wert:
20und veralteter konstanter Name:ABORT_ERR) URLMismatchErrorExperimentell-
Die angegebene URL stimmt nicht mit einer anderen URL überein. (Veralteter Code-Wert:
21und veralteter konstanter Name:URL_MISMATCH_ERR) QuotaExceededError-
Das Kontingent wurde überschritten. (Veralteter Code-Wert:
22und veralteter konstanter Name:QUOTA_EXCEEDED_ERR) Es ist eine richtige Schnittstelle, die vonDOMExceptionabgeleitet ist. TimeoutError-
Die Operation hat ein Timeout überschritten. (Veralteter Code-Wert:
23und veralteter konstanter Name:TIMEOUT_ERR) InvalidNodeTypeErrorExperimentell-
Der Knoten ist für diese Operation falsch oder hat einen falschen Vorfahren. (Veralteter Code-Wert:
24und veralteter konstanter Name:INVALID_NODE_TYPE_ERR) DataCloneErrorExperimentell-
Das Objekt kann nicht geklont werden. (Veralteter Code-Wert:
25und veralteter konstanter Name:DATA_CLONE_ERR) EncodingErrorExperimentell-
Die Kodierungs- oder Dekodierungsoperation ist fehlgeschlagen (Kein veralteter Code-Wert und konstanter Name).
NotReadableErrorExperimentell-
Der Lesevorgang von Ein-/Ausgabe ist fehlgeschlagen (Kein veralteter Code-Wert und konstanter Name).
UnknownErrorExperimentell-
Die Operation ist aus einem unbekannten temporären Grund fehlgeschlagen (z.B. nicht genügend Arbeitsspeicher) (Kein veralteter Code-Wert und konstanter Name).
ConstraintErrorExperimentell-
Eine Mutationsoperation in einer Transaktion ist fehlgeschlagen, weil eine Einschränkung nicht erfüllt wurde (Kein veralteter Code-Wert und konstanter Name).
DataErrorExperimentell-
Die bereitgestellten Daten sind unzureichend (Kein veralteter Code-Wert und konstanter Name).
TransactionInactiveErrorExperimentell-
Eine Anforderung wurde gegen eine Transaktion gestellt, die derzeit nicht aktiv oder abgeschlossen ist (Kein veralteter Code-Wert und konstanter Name).
ReadOnlyErrorExperimentell-
Der Änderungsversuch wurde in einer "readonly"-Transaktion unternommen (Kein veralteter Code-Wert und konstanter Name).
VersionErrorExperimentell-
Es wurde versucht, eine Datenbank mit einer niedrigeren Version als der vorhandenen Version zu öffnen (Kein veralteter Code-Wert und konstanter Name).
OperationErrorExperimentell-
Die Operation ist aus einem spezifischen Grund fehlgeschlagen (Kein veralteter Code-Wert und konstanter Name).
NotAllowedError-
Die Anforderung wird von der Benutzeroberfläche oder der Plattform im aktuellen Kontext nicht erlaubt, möglicherweise weil der Benutzer die Erlaubnis verweigert hat (Kein veralteter Code-Wert und konstanter Name).
Spezifikationen
| Specification |
|---|
| Web IDL # idl-DOMException |
Browser-Kompatibilität
Loading…
Siehe auch
- Ein Polyfill von
DOMExceptionist incore-jsverfügbar DOMError