內容

use_build_context_synchronously

內容

請勿跨非同步間隙使用 BuildContext。

此規則自 Dart 2.13 起可用。

規則集：flutter

詳細資料

#

請勿跨非同步間隙使用 BuildContext。

儲存 BuildContext 以供日後使用很容易導致難以診斷的崩潰。非同步間隙會隱式儲存 BuildContext，且在編寫程式碼時最容易被忽略。

當使用 BuildContext 時，在非同步間隙後，必須根據存取 BuildContext 的方式檢查 mounted 屬性。

  • 當使用 State 的 context 屬性時，必須檢查 State 的 mounted 屬性。
  • 對於其他 BuildContext 實例 (例如區域變數或函式引數)，必須檢查 BuildContext 的 mounted 屬性。

不良範例

dart
void onButtonTapped(BuildContext context) async {
  await Future.delayed(const Duration(seconds: 1));
  Navigator.of(context).pop();
}

良好範例

dart
void onButtonTapped(BuildContext context) {
  Navigator.of(context).pop();
}

良好範例

dart
void onButtonTapped(BuildContext context) async {
  await Future.delayed(const Duration(seconds: 1));

  if (!context.mounted) return;
  Navigator.of(context).pop();
}

良好範例

dart
abstract class MyState extends State<MyWidget> {
  void foo() async {
    await Future.delayed(const Duration(seconds: 1));
    if (!mounted) return; // Checks `this.mounted`, not `context.mounted`.
    Navigator.of(context).pop();
  }
}

用法

#

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

analysis_options.yaml
yaml
linter:
  rules:
    - use_build_context_synchronously

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