api - dart api 划掉了变量

Question

在大多数 Dart 文档页面中，一些变量和函数被划掉。就像 https://api.dartlang.org/1.14.2/dart-js/dart-js-library.html

这意味着什么？

Answer 1

在 Dart metadata可以添加到类、字段、库声明、参数...作为注释。

@Deprecated('some reason')
class SomeClass {
  String someField;
  int otherField;

  SomeClass({
      this.someField, 
      @Deprecated('don\'t use this anymore") this.otherField});
}

就是这样的注释和一些工具，例如Dart分析器和dartdoc使用此信息生成警告(分析器)或其他视觉提示，表明某些 API 仍然存在，但应避免，因为计划最终将其删除。