Dart API

Appearance

dart:html›Classes›DomException

DomException ​

class DomException extends JavaScriptObject

Annotations: @Unstable.new(), @Native.new("DOMException")

Properties ​

hashCode no setter inherited ​

int get hashCode

Inherited from Interceptor.

Implementation
dart
int get hashCode => Primitives.objectHashCode(this);

message no setter ​

String? get message
Implementation
dart
String? get message native;

name no setter ​

String get name
Implementation
dart
String get name {
  var errorName = JS('String', '#.name', this);
  // Although Safari nightly has updated the name to SecurityError, Safari 5
  // and 6 still return SECURITY_ERR.
  if (Device.isWebKit && errorName == 'SECURITY_ERR') return 'SecurityError';
  // Chrome release still uses old string, remove this line when Chrome stable
  // also prints out SyntaxError.
  if (Device.isWebKit && errorName == 'SYNTAX_ERR') return 'SyntaxError';
  return errorName as String;
}

runtimeType no setter inherited ​

Type get runtimeType

Inherited from Interceptor.

Implementation
dart
Type get runtimeType =>
    getRuntimeTypeOfInterceptorNotArray(getInterceptor(this), this);

Methods ​

noSuchMethod() inherited ​

dynamic noSuchMethod(Invocation invocation)

Invoked when a nonexistent method or property is accessed.

A dynamic member invocation can attempt to call a member which doesn't exist on the receiving object. Example:

dart
dynamic object = 1;
object.add(42); // Statically allowed, run-time error

This invalid code will invoke the noSuchMethod method of the integer 1 with an Invocation representing the .add(42) call and arguments (which then throws).

Classes can override noSuchMethod to provide custom behavior for such invalid dynamic invocations.

A class with a non-default noSuchMethod invocation can also omit implementations for members of its interface. Example:

dart
class MockList<T> implements List<T> {
  noSuchMethod(Invocation invocation) {
    log(invocation);
    super.noSuchMethod(invocation); // Will throw.
  }
}
void main() {
  MockList().add(42);
}

This code has no compile-time warnings or errors even though the MockList class has no concrete implementation of any of the List interface methods. Calls to List methods are forwarded to noSuchMethod, so this code will log an invocation similar to Invocation.method(#add, [42]) and then throw.

If a value is returned from noSuchMethod, it becomes the result of the original invocation. If the value is not of a type that can be returned by the original invocation, a type error occurs at the invocation.

The default behavior is to throw a NoSuchMethodError.

Inherited from Interceptor.

Implementation
dart
dynamic noSuchMethod(Invocation invocation) {
  throw NoSuchMethodError.withInvocation(this, invocation);
}

toString() ​

String toString()

A string representation of this object.

Some classes have a default textual representation, often paired with a static parse function (like int.parse). These classes will provide the textual representation as their string representation.

Other classes have no meaningful textual representation that a program will care about. Such classes will typically override toString to provide useful information when inspecting the object, mainly for debugging or logging.

Implementation
dart
String toString() => JS('String', 'String(#)', this);

Operators ​

operator ==() inherited ​

bool operator ==(Object other)

The equality operator.

The default behavior for all Objects is to return true if and only if this object and other are the same object.

Override this method to specify a different equality relation on a class. The overriding method must still be an equivalence relation. That is, it must be:

  • Total: It must return a boolean for all arguments. It should never throw.

  • Reflexive: For all objects o, o == o must be true.

  • Symmetric: For all objects o1 and o2, o1 == o2 and o2 == o1 must either both be true, or both be false.

  • Transitive: For all objects o1, o2, and o3, if o1 == o2 and o2 == o3 are true, then o1 == o3 must be true.

The method should also be consistent over time, so whether two objects are equal should only change if at least one of the objects was modified.

If a subclass overrides the equality operator, it should override the hashCode method as well to maintain consistency.

Inherited from Interceptor.

Implementation
dart
bool operator ==(Object other) => identical(this, other);

Constants ​

ABORT ​

const String ABORT
Implementation
dart
static const String ABORT = 'AbortError';

CONSTRAINT ​

const String CONSTRAINT
Implementation
dart
static const String CONSTRAINT = 'ConstraintError';

DATA_CLONE ​

const String DATA_CLONE
Implementation
dart
static const String DATA_CLONE = 'DataCloneError';

ENCODING ​

const String ENCODING
Implementation
dart
static const String ENCODING = 'EncodingError';

HIERARCHY_REQUEST ​

const String HIERARCHY_REQUEST
Implementation
dart
static const String HIERARCHY_REQUEST = 'HierarchyRequestError';

INDEX_SIZE ​

const String INDEX_SIZE
Implementation
dart
static const String INDEX_SIZE = 'IndexSizeError';

INVALID_ACCESS ​

const String INVALID_ACCESS
Implementation
dart
static const String INVALID_ACCESS = 'InvalidAccessError';

INVALID_CHARACTER ​

const String INVALID_CHARACTER
Implementation
dart
static const String INVALID_CHARACTER = 'InvalidCharacterError';

INVALID_MODIFICATION ​

const String INVALID_MODIFICATION
Implementation
dart
static const String INVALID_MODIFICATION = 'InvalidModificationError';

INVALID_NODE_TYPE ​

const String INVALID_NODE_TYPE
Implementation
dart
static const String INVALID_NODE_TYPE = 'InvalidNodeTypeError';

INVALID_STATE ​

const String INVALID_STATE
Implementation
dart
static const String INVALID_STATE = 'InvalidStateError';

NAMESPACE ​

const String NAMESPACE
Implementation
dart
static const String NAMESPACE = 'NamespaceError';

NETWORK ​

const String NETWORK
Implementation
dart
static const String NETWORK = 'NetworkError';

NO_MODIFICATION_ALLOWED ​

const String NO_MODIFICATION_ALLOWED
Implementation
dart
static const String NO_MODIFICATION_ALLOWED = 'NoModificationAllowedError';

NOT_ALLOWED ​

const String NOT_ALLOWED
Implementation
dart
static const String NOT_ALLOWED = 'NotAllowedError';

NOT_FOUND ​

const String NOT_FOUND
Implementation
dart
static const String NOT_FOUND = 'NotFoundError';

NOT_READABLE ​

const String NOT_READABLE
Implementation
dart
static const String NOT_READABLE = 'NotReadableError';

NOT_SUPPORTED ​

const String NOT_SUPPORTED
Implementation
dart
static const String NOT_SUPPORTED = 'NotSupportedError';

OPERATION ​

const String OPERATION
Implementation
dart
static const String OPERATION = 'OperationError';

QUOTA_EXCEEDED ​

const String QUOTA_EXCEEDED
Implementation
dart
static const String QUOTA_EXCEEDED = 'QuotaExceededError';

READ_ONLY ​

const String READ_ONLY
Implementation
dart
static const String READ_ONLY = 'ReadOnlyError';

SECURITY ​

const String SECURITY
Implementation
dart
static const String SECURITY = 'SecurityError';

SYNTAX ​

const String SYNTAX
Implementation
dart
static const String SYNTAX = 'SyntaxError';

TIMEOUT ​

const String TIMEOUT
Implementation
dart
static const String TIMEOUT = 'TimeoutError';

TRANSACTION_INACTIVE ​

const String TRANSACTION_INACTIVE
Implementation
dart
static const String TRANSACTION_INACTIVE = 'TransactionInactiveError';

TYPE_ERROR ​

const String TYPE_ERROR
Implementation
dart
static const String TYPE_ERROR = 'TypeError';

TYPE_MISMATCH ​

const String TYPE_MISMATCH
Implementation
dart
static const String TYPE_MISMATCH = 'TypeMismatchError';

UNKNOWN ​

const String UNKNOWN
Implementation
dart
static const String UNKNOWN = 'UnknownError';

URL_MISMATCH ​

const String URL_MISMATCH
Implementation
dart
static const String URL_MISMATCH = 'URLMismatchError';

VERSION ​

const String VERSION
Implementation
dart
static const String VERSION = 'VersionError';

WRONG_DOCUMENT ​

const String WRONG_DOCUMENT
Implementation
dart
static const String WRONG_DOCUMENT = 'WrongDocumentError';