runtime_type 1.1.0 copy "runtime_type: ^1.1.0" to clipboard
runtime_type: ^1.1.0 copied to clipboard

A non-opaque representation of types at runtime.

runtime_type #

A non-opaque representation of types at runtime.

Normally, Type objects are opaque and cannot be used for actual logic. RuntimeType allows for operations such as sub- or super-type checking, type checks, and casting using a variable instead of a literal.

To use, replace your type literals with calls to the RuntimeType constructor:

// Before
final stringType = String;
// After
final stringType = RuntimeType<String>();

A word of warning #

Please only use this library if you're sure it's what you want. If you're not completely at ease with the Dart language, ask someone who is whether your problem can be solved some other way, as Dart's type system is normally enough to handle problems.

How it works #

Instead of using Type instances to track information about a type, RuntimeType uses a generic type to hold the same information. Then, by using that generic and Dart's handling of generic subtype checking, we can implement most of the functions that normal type literals have.

If you've seen this trick before, this package uses the same principle:

bool isTypeASubtypeOfB<A, B>() => <A>[] is List<B>;

However, that trick does not work when A and B cannot be resolved statically - which is why this package creates RuntimeType objects statically, but which can then be passed around and used dynamically as the type information is held within the object itself.

7
likes
140
points
1.01k
downloads

Publisher

unverified uploader

Weekly Downloads

A non-opaque representation of types at runtime.

Repository (GitHub)
View/report issues

Documentation

API reference

License

MIT (license)

More

Packages that depend on runtime_type