rspec/rules/S3689/dart/rule.adoc

55 lines
1.4 KiB
Plaintext
Raw Normal View History

== Why is this an issue?
In Dart, `const` is used to declare compile-time constants. It can also be used to declare constant values, typically provided by https://dart.dev/language/constructors#constant-constructors[constant constructors]. This constructor, if used within `const` context will create an instance as a compile-time constant. This is an example of usage of a constant constructor:
Declaration
[source,dart]
----
class Person {
final int age;
final String name;
const Point(this.age, this.name);
}
----
Usage
[source,dart]
----
void f() {
var p = const Person(40, 'A');
var family = const [Person(40, 'A'), Person(39, 'B')];
}
----
When you're already inside the `const` context, there's no need to repeat the keyword. So instead of writing `const [const Person(40, 'A'), const Person(39, 'B')]` you can just write `const [Person(40, 'A'), Person(39, 'B')]`.
This rule raises an issue when `const` modifier was used within another `const` context
=== Noncompliant code example
[source,dart]
----
void f() {
var family = const [const Person(40, 'A'), const Person(39, 'B')];
}
----
=== Compliant solution
[source,dart]
----
void f() {
var family = const [Person(40, 'A'), Person(39, 'B')];
}
----
== Resources
* https://dart.dev/tools/linter-rules/unnecessary_const[Dart Lint rule]
* https://dart.dev/language/constructors#constant-constructors[Constant constructors]
* https://dart.dev/language/classes[Dart classes]