跳到主要內容
目錄

iterable_contains_unrelated_type

目錄
已移除

呼叫 Iterable<E>.contains 時使用了不相關類型的參考。

詳細資訊

#

注意：此規則已在 Dart 3.3.0 中移除；不再起作用。

請勿在 Iterable 上使用與參數類型不同的實例來調用 contains。

這樣做會在元素上調用 ==，而且很可能返回 false。

錯誤範例

dart
void someFunction() {
  var list = <int>[];
  if (list.contains('1')) print('someFunction'); // LINT
}

錯誤範例

dart
void someFunction3() {
  List<int> list = <int>[];
  if (list.contains('1')) print('someFunction3'); // LINT
}

錯誤範例

dart
void someFunction8() {
  List<DerivedClass2> list = <DerivedClass2>[];
  DerivedClass3 instance;
  if (list.contains(instance)) print('someFunction8'); // LINT
}

錯誤範例

dart
abstract class SomeIterable<E> implements Iterable<E> {}

abstract class MyClass implements SomeIterable<int> {
  bool badMethod(String thing) => this.contains(thing); // LINT
}

正確範例

dart
void someFunction10() {
  var list = [];
  if (list.contains(1)) print('someFunction10'); // OK
}

正確範例

dart
void someFunction1() {
  var list = <int>[];
  if (list.contains(1)) print('someFunction1'); // OK
}

正確範例

dart
void someFunction4() {
  List<int> list = <int>[];
  if (list.contains(1)) print('someFunction4'); // OK
}

正確範例

dart
void someFunction5() {
  List<ClassBase> list = <ClassBase>[];
  DerivedClass1 instance;
  if (list.contains(instance)) print('someFunction5'); // OK
}

abstract class ClassBase {}

class DerivedClass1 extends ClassBase {}

正確範例

dart
void someFunction6() {
  List<Mixin> list = <Mixin>[];
  DerivedClass2 instance;
  if (list.contains(instance)) print('someFunction6'); // OK
}

abstract class ClassBase {}

abstract class Mixin {}

class DerivedClass2 extends ClassBase with Mixin {}

正確範例

dart
void someFunction7() {
  List<Mixin> list = <Mixin>[];
  DerivedClass3 instance;
  if (list.contains(instance)) print('someFunction7'); // OK
}

abstract class ClassBase {}

abstract class Mixin {}

class DerivedClass3 extends ClassBase implements Mixin {}

啟用

#

若要啟用 iterable_contains_unrelated_type 規則，請在您的 analysis_options.yaml 檔案中，於 linter > rules 下新增 iterable_contains_unrelated_type

analysis_options.yaml
yaml
linter:
  rules:
    - iterable_contains_unrelated_type

如果您改用 YAML map 語法來設定 linter 規則，請在 linter > rules 下新增 iterable_contains_unrelated_type: true

analysis_options.yaml
yaml
linter:
  rules:
    iterable_contains_unrelated_type: true

除非另有說明，否則本網站上的文件反映的是 Dart 3.7.1 版本。頁面最後更新於 2025-03-07。 檢視原始碼 或 回報問題。