# Breaking changes and deprecations

> A list of breaking changes by release in Dart.








:::warning
**This page has been deprecated.**
See the [Changelog](/changelog) for changes to the language and SDK,
and [Language versioning](/language/versioning) for how versioning is used
with Dart and the SDK.
:::

This page lists all breaking changes and deprecations in
updates to the Dart SDK, organized by release and area,
to help Dart developers understand and manage their impact.
Complete release notes are available in the [Dart SDK changelog][changelog].
The [breaking change policy][] document describes the policy and process
around breaking changes and deprecations in Dart.

**This page includes the following types of breaking changes:**

**Unversioned**
: The Dart SDK doesn't maintain backward compatibility,
  and code might break as soon as you [upgrade your sdk version][sdk] if
  it relies on the previous behavior.

  _These are the majority of changes and aren't specially marked in this list._

**Language versioned**
: The Dart SDK maintains backward compatibility for existing code,
  and the behavior change only takes effect (potentially breaking
  code that relies on the previous behavior) when you
  upgrade the [language version][] of your code.

  _These are marked as:_ <span class="tag-label language-versioned-tag">Language versioned</span>

**Deprecations**
: The Dart SDK maintains compatibility for deprecated code, with a warning.
  Deprecations are then completely removed in a later release,
  breaking any code that relies on the previous behavior.

  _These are marked as:_ <span class="tag-label deprecated-tag">Deprecated</span> / <span class="tag-label removed-tag">Removed</span>

**Experimental**
: Part of the release but not yet treated as stable in the SDK and
  can break from one version to another.
  Experimental changes don't always have a corresponding breaking change issue,
  but might have more details in the [SDK changelog][changelog].

  These are marked: <span class="tag-label experimental-tag">Experimental</span>

If you have questions or concerns about any of these breaking changes,
please comment on the breaking change issue linked from the relevant entry.
To be notified about future breaking changes, join the [Dart announce][] group.

[breaking change policy]: https://github.com/dart-lang/sdk/blob/main/docs/process/breaking-changes.md
[changelog]: https://github.com/dart-lang/sdk/blob/main/CHANGELOG.md
[sdk]: /get-dart
[language version]: /language/versioning
[Dart announce]: https://groups.google.com/a/dartlang.org/g/announce



## 3.15.0

:::note Tentative
Dart 3.15 hasn't been released yet.
The following list is preliminary and might change before release.
:::

### Language {:#3-15-0-language}

- <span class="tag-label language-versioned-tag">Language versioned</span>
  An `import` or `export` directive with
  [more than one `show` or `hide` clause][single-combinator]
  is now a compile-time error.
  Multiple clauses were previously deprecated.
  For example, rewrite `show A, B hide B` as `show A`.
- <span class="tag-label language-versioned-tag">Language versioned</span>
  A type test or null check can now [promote `this`][promote-this].
  Member access through an explicit or implicit `this` uses the promoted type.
  For example, if a subtype narrows a method's parameter from `num` to `int`,
  passing a `double` after the type test is now an error.
- <span class="tag-label language-versioned-tag">Language versioned</span>
  When control flow branches rejoin,
  Dart [preserves type promotions common to both branches][promotion-join],
  even if the branches reached that type through different intermediate types.
  A field can also [lose an earlier promotion][64799] if
  promoting its receiver gives the field an unrelated type on one branch.
  If you need the earlier type after the branches rejoin,
  check the field's type again.

[single-combinator]: https://github.com/dart-lang/language/issues/2824
[promote-this]: https://github.com/dart-lang/language/issues/1397
[promotion-join]: https://github.com/dart-lang/language/issues/4757
[64799]: https://github.com/dart-lang/sdk/issues/64799

### Libraries {:#3-15-0-libraries}

#### `dart:async` {:#3-15-0-dart-async}

- An `async` function that returns a non-future value now
  [completes its future without scheduling an extra microtask][async-complete].
  An uncaught error completes the future in a microtask if
  the function hasn't suspended yet, or directly if it has.
  This can change the order in which callbacks run.
- An uncaught error in an `async` function now goes through the
  [zone's `errorCallback`][async-zone-errors] across all backends.
  If the callback replaces the error, the caller receives the replacement.

[async-complete]: https://github.com/dart-lang/sdk/commit/b6344c6bacc2ca0b9bc8b26bdb917b957175ae3a
[async-zone-errors]: https://github.com/dart-lang/sdk/commit/9c6858e8366f9ccc9bf627f9269b329cade1c35a

#### `dart:core` {:#3-15-0-dart-core}

- [`List.setAll`][list-ranges] now checks the index
  even when the input is empty.
  `List.setRange` now throws a `StateError` when
  the source has too few elements,
  and an `ArgumentError` for a negative `skipCount` when
  the destination range is non-empty.
- [`UriData.fromBytes`][uri-bytes] now throws an `ArgumentError` when
  percent-encoding an integer outside 0-255.

[list-ranges]: https://github.com/dart-lang/sdk/commit/6478280b2a75821930cabb9ae611caf0ad0ee810
[uri-bytes]: https://github.com/dart-lang/sdk/commit/7b3dd7bb6671cbd95b0af83abb5aae8ee9bb2dfb

#### `dart:io` {:#3-15-0-dart-io}

- [`HttpClient` now matches the URI scheme][http-credentials] when
  applying credentials registered with `addCredentials`.
  Credentials registered for HTTPS no longer apply to HTTP requests
  to the same host and port.
- When you set `request.contentLength = -1` on a `GET` or `HEAD` request
  without explicitly enabling chunked transfer encoding,
  `HttpClient` now [waits for the first nonempty chunk][60333]
  before enabling it.
  If the stream is empty, it omits the `Transfer-Encoding` header.
- Setting `HttpHeaders.host` or `HttpHeaders.contentType`
  [now throws a `FormatException`][header-values]
  if the value contains an invalid header character,
  such as a carriage return, a line feed, or a non-ASCII character.
- [Malformed HTTP input now produces more specific exceptions][http-errors].
  For example, an invalid redirect `Location` throws a `RedirectException`,
  and an invalid WebSocket upgrade response can throw a `WebSocketException`.
  `HttpDate.parse` throws an `HttpException` for truncated asctime dates.

[http-credentials]: https://github.com/dart-lang/sdk/pull/64526
[60333]: https://github.com/dart-lang/sdk/issues/60333
[header-values]: https://github.com/dart-lang/sdk/pull/64514
[http-errors]: https://github.com/dart-lang/sdk/commit/ea1c8940495a742b2737cf9307a72a19cfc6592e

#### `dart:typed_data` {:#3-15-0-dart-typed-data}

- [`Float32x4.clamp` and `Float64x2.clamp`][40426] now propagate
  `NaN` if the value or either bound is `NaN` in that lane.
  They also order `-0.0` below `+0.0` when clamping to a zero bound.

[40426]: https://github.com/dart-lang/sdk/issues/40426

### Tools {:#3-15-0-tools}

#### Analyzer {:#3-15-0-analyzer}

- <span class="tag-label deprecated-tag">Deprecated</span>
  The analyzer now [warns about conditional imports and exports][61875]
  that test for a deprecated web library, such as `dart.library.html`.
  To select a web implementation that uses `dart:js_interop`,
  check for `dart.library.js_interop` instead.
- The analyzer now
  [uses new diagnostic codes for failed name lookups][64411].
  For example, `undefined_super_member` is now `undefined_super_member_read`,
  `undefined_super_member_write`, or `undefined_super_operator`.
  Update ignore comments or severity overrides that use the old codes.
- The analyzer now reports [`argument_type_not_assignable`][64561]
  for an incompatible value assigned through `operator []=`.
  Update any ignores for `invalid_assignment`
  that applied to the value in `a[i] = value`.
- With the [`strict-inference`][strict-inference] mode enabled,
  the analyzer now [reports inference failures for `f.call()`][64625] when
  `f` has a generic function type.

[61875]: https://github.com/dart-lang/sdk/issues/61875
[64411]: https://github.com/dart-lang/sdk/issues/64411
[64561]: https://github.com/dart-lang/sdk/issues/64561
[strict-inference]: /tools/analysis#enabling-additional-type-checks
[64625]: https://github.com/dart-lang/sdk/issues/64625

#### Pub {:#3-15-0-pub}

- On Windows, Pub now [requires `git.exe` on `PATH`][pub-git-refs]
  for Git operations.
  If you use a `git.cmd` or `git.bat` wrapper,
  add the directory containing `git.exe` to `PATH`.
- Pub now [rejects Git dependency refs][pub-git-refs] that are empty,
  start with `-`, or contain whitespace or control characters.
  A `resolved-ref` in `pubspec.lock` must be a full hexadecimal commit ID.
- [`dart pub publish` now creates reproducible archives][pub-archives].
  Archive entries have a consistent order and timestamps set to the Unix epoch,
  so tools reading a package archive can
  no longer recover the original file timestamps.

[pub-git-refs]: https://github.com/dart-lang/pub/pull/4941
[pub-archives]: https://github.com/dart-lang/pub/pull/4885

### Runtime {:#3-15-0-runtime}

#### Embedder API {:#3-15-0-embedder-api}

- <span class="tag-label removed-tag">Removed</span>
  The VM [replaced `Dart_SetEnvironmentCallback` and
  `Dart_EnvironmentCallback`][embedder-environment] in `dart_api.h`.
  Call `Dart_SetEnvironment` with a `NULL`-terminated array of alternating
  UTF-8 keys and values to set the environment for the current isolate.

[embedder-environment]: https://github.com/dart-lang/sdk/commit/f54481dd92ccd119ee20dd6311c8b603055d9838

## 3.14.0

:::note Tentative
Dart 3.14 hasn't been released yet.
The following list is preliminary and might change before release.
:::

### Language {:#3-14-0-language}

- A subpattern in a list, map, or record pattern [no longer
  promotes the entire matched property to the subpattern's type][64269].
  For example, when `c._items` is a private final field of type `Object?`,
  `if (c._items case [int item])` lets you use `item.isEven`.
  Dart now rejects `c._items.isEven` inside that `if`.

[64269]: https://github.com/dart-lang/sdk/issues/64269

### Libraries {:#3-14-0-libraries}

#### `dart:ffi` {:#3-14-0-dart-ffi}

- <span class="tag-label experimental-tag">Experimental</span>
  Calling [`NativeCallable.isolateGroupBound`][64285]
  now requires the `--experimental-shared-data` VM flag.

#### `dart:io` {:#3-14-0-dart-io}

- On macOS, `Process.start`, `Process.run`, and `Process.runSync` now
  [search the parent process's `PATH`][mac-process] for the executable.
  If you previously set `PATH` in the child's `environment` to
  select an executable, pass its absolute path instead.

[mac-process]: https://github.com/dart-lang/sdk/commit/0171629a54781f3672629b1f85afa74e9d4022ca

#### `dart:isolate` {:#3-14-0-dart-isolate}

- <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label removed-tag">Removed</span>
  Dart 3.13 exposed experimental APIs for
  running isolates synchronously and controlling their event loops.
  `Isolate` [no longer exposes][64285]
  `create`, `runSync`, `shutdownSync`, `pinToCurrentThread`,
  `isPinnedToCurrentThread`, `runEventLoopSync`, `onEvent`, or `handleEvent`.

[64285]: https://github.com/dart-lang/sdk/issues/64285

#### `dart:js_interop` {:#3-14-0-dart-js-interop}

- [`isA<JSArray>()`][62699] now also recognizes arrays created in
  another JavaScript realm, such as an iframe.
- If a `Future` completes with a JavaScript error value,
  [`toJS` now rejects the resulting promise with that value directly][61353].
  Code that handles the rejection can no longer assume every reason
  is a wrapper with `error` and `stack` properties.
- Annotating an `external` constructor or factory
  of a JS interop extension type with `@JS`
  is [now a compile-time error][61274].
  To specify the name of the JavaScript constructor,
  move the annotation to the extension type declaration.

[62699]: https://github.com/dart-lang/sdk/issues/62699
[61353]: https://github.com/dart-lang/sdk/issues/61353
[61274]: https://github.com/dart-lang/sdk/issues/61274

#### `dart:mirrors` {:#3-14-0-dart-mirrors}

- <span class="tag-label deprecated-tag">Deprecated</span>
  The [`dart:mirrors` library is deprecated][44489]
  and will be removed in a future release.
- When you use a `LibraryMirror` to invoke a top-level function or
  access a field, [use the library that declares the member][re-exports].
  The VM no longer looks up members through re-exports.

[44489]: https://github.com/dart-lang/sdk/issues/44489
[re-exports]: https://github.com/dart-lang/sdk/commit/0fb613f63806a22f469b47e60911674542fc08c6

#### `dart:typed_data` {:#3-14-0-dart-typed-data}

- [`toString()` on `Float32x4`, `Int32x4`, and `Float64x2`][63847]
  now returns `'V128'`.
  To display lane values, read the lane getters.
  On the VM, the debugger and `Error.safeToString` also display `V128`.
- On `Float32x4` and `Float64x2`, [`min` and `max`][63962] now return
  `NaN` in any lane where either input is `NaN`.
  When comparing `-0.0` and `+0.0`,
  `min` returns `-0.0` and `max` returns `+0.0`.

[63847]: https://github.com/dart-lang/sdk/issues/63847
[63962]: https://github.com/dart-lang/sdk/issues/63962

### Tools {:#3-14-0-tools}

#### Dart command line {:#3-14-0-dart-cli}

- When `dart run <package>:<command>` or `dart test` runs a
  [cached executable][executable-cache],
  `Platform.script` now points to the Dart source file.
  The snapshot cache moved from `.dart_tool/pub/bin/`
  to `.dart_tool/dartdev/bin/`.

[executable-cache]: https://github.com/dart-lang/sdk/commit/ed26759eab93df8ec649bdc49551ee16c341bda0

#### Pub {:#3-14-0-pub}

- <span class="tag-label deprecated-tag">Deprecated</span>
  The [`--precompile` and `--no-precompile` flags][pub-precompile] now
  have no effect on `dart pub get`, `upgrade`, `add`, or `remove`.
  You can remove these flags from scripts.
- Pub now [rejects Git dependencies][pub-symlinks] that contain
  absolute symbolic links,
  links that lead outside the repository,
  or link cycles.
  Use relative links that resolve inside the repository.
- Pub now [rejects Git dependency URLs][pub-git-urls] that
  start with `-` or use Git's `ext` protocol.

[pub-precompile]: https://github.com/dart-lang/pub/pull/4910
[pub-symlinks]: https://github.com/dart-lang/pub/pull/4894
[pub-git-urls]: https://github.com/dart-lang/pub/pull/4895

#### Wasm compiler (dart2wasm) {:#3-14-0-dart2wasm}

- WebAssembly modules compiled for the web now require native support for
  [`wasm:js-string` built-ins][63543].
  The compiler also emits
  [standard WebAssembly exception handling instructions][54394]
  (`try_table`) by default.
  Runtimes that only support the legacy exception handling instructions
  can't load modules that use `try_table`.
- [`dart.library.isolate` now evaluates to `false`][64328]
  when compiling to WebAssembly.
  Conditional imports and exports now skip the
  `if (dart.library.isolate)` branch.
- <span class="tag-label experimental-tag">Experimental</span>
  `dart compile wasm --standalone` no longer supports `dart:js_interop`.

[63543]: https://github.com/dart-lang/sdk/issues/63543
[54394]: https://github.com/dart-lang/sdk/issues/54394
[64328]: https://github.com/dart-lang/sdk/issues/64328

### Runtime {:#3-14-0-runtime}

#### Embedder API {:#3-14-0-embedder-api}

- When you pass a library to `Dart_Invoke`, `Dart_GetField`, or `Dart_SetField`,
  the VM now [looks up members in that library only][re-exports].
- <span class="tag-label removed-tag">Removed</span>
  The [`NativeAssetsApi` struct][native-assets-api] in `dart_api.h`
  replaces `dlopen_v2` with two callbacks.
  If you used `dlopen_v2`,
  provide `contains_asset` to check whether an asset ID is registered
  and `dlopen_asset` to load it.

[native-assets-api]: https://github.com/dart-lang/sdk/commit/eb5d7983230621e9f09ea54500008ff4259fd50a

## 3.13.7

### Libraries {:#3-13-7-libraries}

#### `dart:io` {:#3-13-7-dart-io}

- On Android, Windows, and Linux, TLS connections now reject chains that
  use [compromised eMudhra intermediate certificates][emudhra].
  On Android 14 and later, Dart also honors root certificate changes
  delivered through Google Play system updates.

[emudhra]: https://github.com/dart-lang/sdk/security/advisories/GHSA-frr6-h895-5pxp

## 3.13.2

### Tools {:#3-13-2-tools}

#### Analyzer {:#3-13-2-analyzer}

- <span class="tag-label deprecated-tag">Deprecated</span>
  The analyzer now [warns when you configure legacy plugins][62164]
  in the `analyzer` section of `analysis_options.yaml`.
  Enable plugins that support the [new plugin system][analyzer plugins]
  in the top-level `plugins` section.

[62164]: https://github.com/dart-lang/sdk/issues/62164
[analyzer plugins]: /tools/analyzer-plugins

#### Formatter (`dart format`) {:#3-13-2-formatter}

- When an enum with a primary constructor has its values on separate lines,
  the formatter now [adds a missing trailing comma][enum-comma]
  after the last value unless a semicolon follows it.

[enum-comma]: https://github.com/dart-lang/dart_style/issues/1888

## 3.13.0

### Language

- <span class="tag-label language-versioned-tag">Language versioned</span>
  You can no longer use `final` or `var` on non-declaring parameters.
  Dart now reserves both for
  [declaring parameters in primary constructors][primary constructors].
  Remove `final` or `var` from affected parameter declarations.
  If you still want to prevent parameter reassignment,
  you can use the [`parameter_assignments`][] lint rule.
- Type promotion in inner generator functions has been [adjusted][62889].

[62889]: https://github.com/dart-lang/sdk/issues/62889
[primary constructors]: /language/primary-constructors#field-declarations-in-parameters
[`parameter_assignments`]: /tools/linter-rules/parameter_assignments

### Libraries

#### `dart:io`

- `NetworkInterface.addresses` [now returns `List<InterfaceAddress>`][63216]
  instead of `List<InternetAddress>`.
  The new `InterfaceAddress` subtype of `InternetAddress`
  exposes a `prefixLength` field and a `broadcast` getter.
  Code that implements `NetworkInterface` and overrides `addresses`
  must update the return type.
- `InternetAddress.lookup` no longer accepts invalid IPv4 addresses
  that are traditionally accepted by `inet_aton`.
- File access and modification timestamps now
  [preserve microsecond precision][42444] where the file system supports it.
  Code that compares these timestamps at millisecond precision
  can use `millisecondsSinceEpoch`.

[63216]: https://github.com/dart-lang/sdk/issues/63216
[42444]: https://github.com/dart-lang/sdk/issues/42444

#### `dart:js_interop`

- `JSFunction` and `JSExportedDartFunction` are [now generic][54557].
  `JSExportedDartFunction<T>.toDart` now casts
  the original wrapped function to the type argument `T`,
  and `isA<JSExportedDartFunction<T>>` now also
  checks that the wrapped function is a `T`.
  The runtime types of `JSFunction` and `JSExportedDartFunction` don't change.

[54557]: https://github.com/dart-lang/sdk/issues/54557

### Tools

#### Analyzer

- <span class="tag-label deprecated-tag">Deprecated</span>
  The [`avoid_private_typedef_functions`][] lint rule
  is deprecated and should be removed from `analysis_options.yaml` files.

- <span class="tag-label deprecated-tag">Deprecated</span>
  The [`one_member_abstracts`][] lint rule
  is deprecated and should be removed from `analysis_options.yaml` files.

[`avoid_private_typedef_functions`]: /tools/linter-rules/avoid_private_typedef_functions
[`one_member_abstracts`]: /tools/linter-rules/one_member_abstracts

#### Formatter (`dart format`)

- Stopped adding a blank line before a comment at
  the end of a compilation unit or braced body.
- Extension type representation clauses are now formatted the same way
  primary constructor formal parameter lists are formatted.
- When [trailing commas are preserved][trailing-commas],
  no longer insert a newline before the `;` in an enum with members
  unless there is a trailing comma.
- Fixed a bug where some collections or arguments might split unnecessarily.

- <span class="tag-label language-versioned-tag">Language versioned</span>
  Parameter lists can now be block formatted.
- <span class="tag-label language-versioned-tag">Language versioned</span>
  `as`, `is`, and `is!` expressions can now be block formatted.
- <span class="tag-label language-versioned-tag">Language versioned</span>
  Blank lines are added around `mixin` and `extension type` declarations
  if they don't have a `;` body.
- <span class="tag-label language-versioned-tag">Language versioned</span>
  Imports are now separated into sections.
- <span class="tag-label language-versioned-tag">Language versioned</span>
  Trailing commas are now added to split extension type representation clauses.
- <span class="tag-label language-versioned-tag">Language versioned</span>
  The formatter now prefers to split a method call chain
  when its target has a single argument or element.
  It also changes how it splits chains with large collection arguments.
- <span class="tag-label language-versioned-tag">Language versioned</span>
  When an `if`-case pattern splits across lines,
  the formatter can now put the `when` guard on its own line.
- <span class="tag-label language-versioned-tag">Language versioned</span>
  When no layout fits the page width, the formatter now prefers to let
  a trailing string literal or comment extend past it.

[trailing-commas]: /tools/analysis#trailing_commas

### Runtime

- <span class="tag-label removed-tag">Removed</span>
  The built-in fallback root certificates used when
  system certificates can't be found are no longer included.
  If the system certificates can't be found,
  use the `--root-certs-file` or `--root-certs-cache` options
  to provide fallback certificates to the standalone Dart VM.

#### Embedder API

- `Dart_FileModifiedCallback` in `runtime/include/dart_tools_api.h` now
  passes `int64_t since` as microseconds from epoch instead of milliseconds.

## 3.12.0

### Libraries

#### `dart:js_interop`

- The `isA` extension method has
  [moved from `JSAnyUtilityExtension` to `NullableObjectUtilExtension`][56905]
  to support type-checking any `Object?`.
  This change is only breaking if you referred to the extension name directly,
  either by applying the extension directly or through `show`/`hide` directives.
- `isA<JSObject>()` now correctly handles JS objects with no prototypes,
  and `isA<JSAny>()` does a non-trivial check that the value is a JS value.
- `isA<JSExportedDartFunction>()` now checks whether the function is
  actually a JS wrapper function that's returned from
  `Function.toJS` or `Function.toJSCaptureThis`.

[56905]: https://github.com/dart-lang/sdk/issues/56905

### Tools

#### Pub

- `dart pub cache repair` now only repairs the packages referenced
  by the current project's `pubspec.lock` file by default.
  To repair all packages in the pub cache as in previous releases,
  pass the new `--all` flag.

#### Wasm compiler (dart2wasm)

- The deferred loading module loader API has been updated to allow
  batched fetching of deferred modules.
  The embedder now takes `loadDeferredModules` instead of `loadDeferredModule`,
  where the new function should expect an array of module names
  rather than individual module names.
  All the module loading functions must now also accept an `instantiator`
  callback to which they should pass the loaded results.

#### Production JavaScript compiler (dart2js)

- `JSExportedDartFunction.toDart` now throws if the wrapper JS function
  wasn't a result of `Function.toJS` or `Function.toJSCaptureThis`,
  to be consistent with DDC and dart2wasm.
  Previously, it would sometimes incorrectly return the
  original Dart function even if the wrapper JS function was
  cast from a call to the deprecated `allowInterop` function.

## 3.11.0

### Tools

#### Analyzer

- <span class="tag-label deprecated-tag">Deprecated</span>
  The [`avoid_null_checks_in_equality_operators`][] lint rule
  is deprecated and should be removed from `analysis_options.yaml` files.

- <span class="tag-label deprecated-tag">Deprecated</span>
  The [`prefer_final_parameters`][] lint rule
  is deprecated and should be removed from `analysis_options.yaml` files.

- <span class="tag-label deprecated-tag">Deprecated</span>
  The [`use_if_null_to_convert_nulls_to_bools`][] lint rule
  is deprecated and should be removed from `analysis_options.yaml` files.

[`avoid_null_checks_in_equality_operators`]: /tools/linter-rules/avoid_null_checks_in_equality_operators
[`prefer_final_parameters`]: /tools/linter-rules/prefer_final_parameters
[`use_if_null_to_convert_nulls_to_bools`]: /tools/linter-rules/use_if_null_to_convert_nulls_to_bools

#### Wasm compilation (`dart compile wasm`)

- <span class="tag-label removed-tag">Removed</span>
  Code that imports `dart:js_util` or `package:js` now
  [results in a compilation error][61550] when compiling to WebAssembly.

  Invoking any API from these libraries will result in a runtime error.
  Usages should be migrated to `dart:js_interop` and `dart:js_interop_unsafe`.

[61550]: https://github.com/dart-lang/sdk/issues/61550

## 3.10.0

### Language

- `sync*` and `async*` generator functions without a specified return now
  correctly infer return types as non-nullable when no `null` value is yielded.
  This might trigger new diagnostics related to unnecessary code elements,
  such as an unnecessary null-aware access operator (`?.`).

### Libraries

#### `dart:core`

- The `Uri.parseIPv4Address` and `Uri.parseIPv6Address` functions
  [no longer incorrectly allow][61392] leading zeros in IPv4 addresses.

- <span class="tag-label deprecated-tag">Deprecated</span>
  The ability to implement `RegExp` and `RegExpMatch` is deprecated
  and will be removed in a future release.

[61392]: https://github.com/dart-lang/sdk/issues/61392

#### `dart:io`

- `IOOverrides` can [no longer be implemented][56468],
  but can still be extended.

[56468]: https://github.com/dart-lang/sdk/issues/56468

#### `dart:js_interop`

- The `Uint16ListToJSInt16Array` extension has been
  renamed to `Uint16ListToJSUint16Array`.

- The `JSUint16ArrayToInt16List` extension has been
  renamed to `JSUint16ArrayToUint16List`.

- The `Function.toJSCaptureThis` function now results in additional
  compile-time checks to match `Function.toJS`.
  If the function doesn't have a statically known type,
  has unsupported types in its signature, includes type parameters,
  or has any named parameters, the call will result in a compile-time error.

### Tools

#### SDK

- The `dart` CLI and Dart VM are now separate executables,
  with the pure Dart VM executable and process called `dartvm`.
  Dart programs should still be run with [`dart run`][].

- Subcommands of the `dart` tool, such as `dart format` and `dart compile`
  now run AOT-compiled snapshots of the underlying tools.
  There should be no functional difference outside of performance improvements,
  but if you come across incompatibilities, please [report them][sdk report].

- <span class="tag-label removed-tag">Removed</span>
  The `dart` tool is no longer available for IA32 platforms
  as the Dart SDK no longer supports IA32.

[`dart run`]: /tools/dart-run
[sdk report]: https://github.com/dart-lang/sdk/issues/new/choose

#### Analyzer

- Using members marked as `@experimental` outside
  the package they are declared in
  now results in a warning.

- Lint rules enabled in included analysis options files
  now result in incompatible lint diagnostics when appropriate.

- <span class="tag-label removed-tag">Removed</span>
  The deprecated `@required` annotation from
  `package:meta` is no longer supported.
  To mark a parameter as required, instead use the `required` keyword.

#### Wasm compilation (`dart compile wasm`)

- `dart:js_util` and `package:js` are [no longer supported][61550] when
  compiling to WebAssembly.
  Invoking any API from these libraries will result in a runtime error.
  Usages should be migrated to `dart:js_interop` and `dart:js_interop_unsafe`.

- To match the JS compilers, `dartify` when compiled to Wasm,
  [now converts][54573] JS `Promise` objects to Dart `Future` objects
  instead of Dart `JSValue` objects. 

[61550]: https://github.com/dart-lang/sdk/issues/61550
[54573]: https://github.com/dart-lang/sdk/issues/54573

## 3.9.0

### Language

- <span class="tag-label language-versioned-tag">Language versioned</span>
  Null safety is now assumed when computing
  type promotion, reachability, and definite assignment.
  As a result, improved dead code analysis might
  cause new analyzer diagnostics to trigger on
  existing code that previously passed analysis.

### Tools

- Some subcommands of the `dart` tool, such as `dart analyze` and `dart fix`
  now run AOT-compiled snapshots of the underlying tools.
  There should be no functional difference outside of performance improvements,
  but if you come across incompatibilities, please [report them][sdk report].

[sdk report]: https://github.com/dart-lang/sdk/issues/new/choose

#### Pub

- <span class="tag-label language-versioned-tag">Language versioned</span>
  The upper bound of the  `flutter` SDK constraint
  in your workspace's root package is now respected.
  If your current SDK doesn't meet the specified bound,
  `dart pub get` and other actions that retrieve dependencies will fail.

#### Dart build

- <span class="tag-label experimental-tag">Experimental</span>
  Building a CLI app bundle with experimental native asset support now
  requires using the `dart build cli` subcommand and
  specifying the app entrypoint with a new `--target` option.

## 3.8.0

### Libraries

#### `dart:html`

- <span class="tag-label removed-tag">Removed</span>
  The `Element.created` constructor has been removed.
- Native classes in `dart:html`, such as `HtmlElement`,
  [can no longer be extended][53264].

[53264]: https://github.com/dart-lang/sdk/issues/53264

### Tools

#### Analyzer

- <span class="tag-label deprecated-tag">Deprecated</span>
  The [`avoid_null_checks_in_equality_operators`][] lint rule
  is deprecated and should be removed from `analysis_options.yaml` files.

[`avoid_null_checks_in_equality_operators`]: /tools/linter-rules/avoid_null_checks_in_equality_operators

#### Development JavaScript compiler (DDC)

- Now throws a runtime error when a
  redirecting factory constructor is [torn off][tear-offs] and
  one of its optional non-nullable parameters is provided no value.
  In the future this is likely to be a compile-time error.

[tear-offs]: /language/functions#tear-offs

#### Production JavaScript compiler (dart2js)

- <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label removed-tag">Removed</span>
  The `--experiment-new-rti` and `--use-old-rti` flags are no longer supported.

#### Formatter (`dart format`)

- <span class="tag-label language-versioned-tag">Language versioned</span>
  The formatter made changes and fixes that result in new output when
  formatting code with a [language version][] of 3.8 or greater.

[language version]: /language/versioning

## 3.7.0

### Language

- <span class="tag-label language-versioned-tag">Language versioned</span> [Local variables and parameters named `_`][wildcards] are
  now non-binding and can no longer be used or accessed.
- [Reachability analysis now accounts for if a field is
  type promoted to `Null` using `is` or `as`][56893].
  This makes the type system more self-consistent, because it
  mirrors the behavior of promoted local variables.
  This change isn't expected to make any difference in practice.

[wildcards]: /language/variables#wildcard-variables
[56893]: https://github.com/dart-lang/sdk/issues/56893

### Libraries

#### `dart:html`, `dart:indexed:db`, `dart:svg`, `dart:web_audio`, `dart:web_gl`, `dart:js`

- <span class="tag-label deprecated-tag">Deprecated</span> These legacy web libraries are officially deprecated.
  They are expected to be removed in a future release.
  Project should migrate to use [`package:web`][] and `dart:js_interop`.
  To learn more, check out [Migrate to `package:web`][].

[`package:web`]: https://pub.dev/packages/web
[Migrate to `package:web`]: /interop/js-interop/package-web

#### `dart:js`, `dart:js_util`, `package:js`

- <span class="tag-label deprecated-tag">Deprecated</span> These legacy JS-interop libraries are officially deprecated.
  They are expected to be removed in a future release.
  Projects should migrate to use `dart:js_interop`.
  To learn more, check out [JS interop usage][].

[JS interop usage]: /interop/js-interop/usage

### Tools

#### Analyzer

- <span class="tag-label removed-tag">Removed</span> The [`package_api_docs`][] and [`unsafe_html`][] lint rules
  have been removed and should be removed from `analysis_options.yaml` files.

[`package_api_docs`]: /tools/linter-rules/package_api_docs
[`unsafe_html`]: /tools/linter-rules/unsafe_html

#### Formatter (`dart format`)

- <span class="tag-label language-versioned-tag">Language versioned</span> The formatter implements a [new style][] that results in
  new output when formatting code with a [language version][] of 3.7 or greater.
- <span class="tag-label removed-tag">Removed</span> The `--fix` flag for `dart format` is no longer supported.
  To apply similar fixes and more,
  [configure your analysis options][] and run [`dart fix`][].
- <span class="tag-label deprecated-tag">Deprecated</span> The `--line-length` option for `dart format` has been
  deprecated and set to be removed.
  All usages should be migrated to the new `--page-width` option.

[new style]: https://github.com/dart-lang/dart_style/issues/1253
[language version]: /language/versioning
[configure your analysis options]: /tools/analysis
[`dart fix`]: /tools/dart-fix

## 3.6.0

### Language

- [The context used by Dart to perform type inference on
  the operand of a throw expression has been changed from
  the "unknown type" to `Object`][56065].
  This makes the type system more self-consistent, because
  it reflects the fact that it's not legal to throw `null`.
  This change isn't expected to make any difference in practice.

[56065]: https://github.com/dart-lang/sdk/issues/56065

### Libraries

#### `dart:io`

- <span class="tag-label removed-tag">Removed</span> [The `Platform()` constructor has been removed][52444].
  All instantiations of `Platform` should be removed.
- `HttpClient` now responds to a redirect that's missing a "Location" header by
  [throwing a `RedirectException` instead of a `StateError`][53618].

[52444]: https://github.com/dart-lang/sdk/issues/52444
[53618]: https://github.com/dart-lang/sdk/issues/53618

### Tools

#### Analyzer

- <span class="tag-label deprecated-tag">Deprecated</span> The [`package_api_docs`][] and [`unsafe_html`][] lint rules
  have been deprecated and are set to be removed in Dart 3.7.

[`package_api_docs`]: /tools/linter-rules/package_api_docs
[`unsafe_html`]: /tools/linter-rules/unsafe_html

#### Compiler front end (cfe)

- The Dart compiler now [computes the upper and lower closures of type schemas
  just before they're passed into the subtype testing procedure][56466].
  Before Dart 3.6, the compiler computed them at the very beginning of
  the upper and lower-bound computations.
  The analyzer already followed this behavior, so apps that
  already pass analysis are unlikely to be affected by this change.

[56466]: https://github.com/dart-lang/sdk/issues/56466

#### Wasm compiler (dart2wasm)

- The condition `dart.library.js` is now `false` on conditional imports
  when compiling to WebAssembly.
  The `dart.library.js_interop` condition should be used instead.

#### Formatter (`dart format`)

The following changes might result in small formatting changes
when running `dart format` with a Dart 3.6 SDK or later:

- Preserve type parameters on old-style function-typed formals that
  also use `this.` or `super.`.
- Correctly format imports with both `as` and `if` clauses.

#### Pub

- `dart pub publish` now warns if files that are
  tracked in git have uncommitted changes.

## 3.5.0

### Language

- [The context used by the compiler to perform type inference on
  the operand of an `await` expression has been changed to
  match the behavior of the analyzer.][55418]
- [The context used by the compiler to perform type inference on
  the right-hand side of an "if-null" expression (`e1 ?? e2`) has been
  changed to match the behavior of the analyzer.][55436]
  The old behavior can be restored by supplying explicit types.

[55418]: https://github.com/dart-lang/sdk/issues/55418
[55436]: https://github.com/dart-lang/sdk/issues/55436

### Libraries

#### `dart:core`

- [`DateTime` now stores microseconds on the web platform][44876],
  more closely matching the behavior on native platforms.

[44876]: https://github.com/dart-lang/sdk/issues/44876

#### `dart:io`

- [`SecurityContext` is now final and can no longer be subclassed][55786].

[55786]: https://github.com/dart-lang/sdk/issues/55786

#### `dart:js_interop`

- [`importModule` now accepts a `JSAny` instead of a `String`][55508] to
  support other JS values as well, such as `TrustedScriptURL` objects.
- [`isTruthy` and `not` now return `JSBoolean` instead of `bool`][55267] to
  be consistent with other JS operator methods.
- [`ExternalDartReference` no longer implements `Object`][56015].
  Instead, it now accepts a type parameter (`T`) with a bound of
  `Object?` to capture the type of the Dart object that is externalized.

[55508]: https://github.com/dart-lang/sdk/issues/55508
[55267]: https://github.com/dart-lang/sdk/issues/55267
[56015]: https://github.com/dart-lang/sdk/issues/56015

#### `dart:typed_data`

- <span class="tag-label removed-tag">Removed</span>
  [The unmodifiable view classes for typed data have been removed][53128].
  Instead of using the constructors of these classes, use
  the new `asUnmodifiableView` methods on typed data lists.

### Runtime

- <span class="tag-label removed-tag">Removed</span> The Dart VM no longer supports unsound null safety.
  - The `--no-sound-null-safety` CLI option has been removed.
  - The `Dart_NewListOf` and `Dart_IsLegacyType` functions have been
    removed from the C API.
- <span class="tag-label removed-tag">Removed</span> The `Dart_DefaultCanonicalizeUrl` function has been
  removed from the C API.

## 3.4.0

### Language

- [The pattern context type schema for cast patterns
  is now `_` (the unknown type) instead of `Object?`][54640].
- [The type schema used by the Dart compilers to
  perform type inference on the operand of a null-aware spread operator (`...?`)
  in map and set literals has been made nullable][54828],
  to match what currently happens in list literals.

[54640]: https://github.com/dart-lang/sdk/issues/54640
[54828]: https://github.com/dart-lang/sdk/issues/54828

### Libraries

#### `dart:cli`

- <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label removed-tag">Removed</span> [The `waitFor` function][52121]
  has been removed.

[52121]: https://github.com/dart-lang/sdk/issues/52121

#### `dart:html`, `dart:indexed:db`, `dart:svg`, `dart:web_audio`, `dart:web_gl`

- <span class="tag-label deprecated-tag">Deprecated</span> These libraries are now marked as legacy and
  will see less support in the future.
  New projects should prefer to use [`package:web`][] and `dart:js_interop`.
  To learn more, check out [Migrate to `package:web`][].

[`package:web`]: https://pub.dev/packages/web
[Migrate to `package:web`]: /interop/js-interop/package-web

#### `dart:js`

- <span class="tag-label deprecated-tag">Deprecated</span>
  This library is now marked as legacy and will see less support in the future.
  Usages should be migrated to `dart:js_interop` and `dart:js_interop_unsafe`.
  To learn more, check out [`/go/next-gen-js-interop`][].

[`/go/next-gen-js-interop`]: https://dart.dev/go/next-gen-js-interop

#### `dart:js_util`

- <span class="tag-label deprecated-tag">Deprecated</span>
  This library is now marked as legacy and will see less support in the future.
  Usages should be migrated to `dart:js_interop` and `dart:js_interop_unsafe`.
  To learn more, check out [`/go/next-gen-js-interop`][].

[`/go/next-gen-js-interop`]: https://dart.dev/go/next-gen-js-interop

#### `dart:io`

- [`Stdout` has a new field `lineTerminator`, which allows
  developers to control the line ending used by `stdout` and `stderr`.][53863]
  Classes that implement `Stdout` must define the `lineTerminator` field.
  The default semantics of `stdout` and `stderr` are not changed.
- <span class="tag-label deprecated-tag">Deprecated</span> The `FileSystemDeleteEvent.isDirectory` property. 
  It always returns `false`.

[53863]: https://github.com/dart-lang/sdk/issues/53863

#### `dart:typed_data`

- <span class="tag-label deprecated-tag">Deprecated</span>
  [The unmodifiable view classes for typed data are deprecated][53128].
  Instead of using the constructors of these classes, use
  the new `asUnmodifiableView` methods on typed data lists.

[53128]: https://github.com/dart-lang/sdk/issues/53218

### Tools

#### Production JavaScript compiler (dart2js)

- <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label deprecated-tag">Deprecated</span> You should now specify a format to
  the `--dump-info` CLI option of either `binary` or `json`.
  The `json` format is deprecated and might be removed in a future Dart release.

#### Wasm compiler (dart2wasm)

- <span class="tag-label experimental-tag">Experimental</span> Various `dart compile wasm` CLI arguments have
  been updated, removed, or replaced.
  To learn more, run `dart compile wasm --verbose --help`.

### Runtime

- <span class="tag-label removed-tag">Removed</span> The Dart VM longer supports external strings.
  As a result, the `Dart_IsExternalString`, `Dart_NewExternalLatin1String`, and
  `Dart_NewExternalUTF16String` functions have been removed from the Dart C API.

## 3.3.0

### SDK

* <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label removed-tag">Removed</span> The following experiments are now retired as
  they were released in Dart 3 and are no longer necessary with
  a language version of 3.0 or greater.
  Configuration of them should be removed from
  analysis options, CLI commands, and IDE configurations.

  * `patterns`
  * `records`
  * `class-modifiers`
  * `sealed-class`

### Language

* [An abstract getter is now considered promotable if
  there are no conflicting declarations][54056].

[54056]: https://github.com/dart-lang/sdk/issues/54056

### Libraries

#### `dart:cli`

* <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label deprecated-tag">Deprecated</span> [The `waitFor` function][52121]
  remains deprecated for another release and is set for removal in Dart 3.4.

[52121]: https://github.com/dart-lang/sdk/issues/52121

#### `dart:ffi`

* <span class="tag-label deprecated-tag">Deprecated</span> [The `elementAt` pointer arithmetic methods
  on `Pointer` types are deprecated][54250].
  Migrate to the `-` and `+` operators instead.
* <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label removed-tag">Removed</span> The previously deprecated
  `@FfiNative` annotation has been removed. Usages should be
  updated to use the `@Native` annotation.

[54250]: https://github.com/dart-lang/sdk/issues/54250

#### `dart:html`

* Instead of using `HttpRequest` directly,
  it is now recommended to use [`package:http`][].

[`package:http`]: https://pub.dev/packages/http

#### `dart:io`

* Instead of using `HttpClient` directly,
  it is now recommended to use [`package:http`][].

[`package:http`]: https://pub.dev/packages/http

#### `dart:js_interop`

* <span class="tag-label experimental-tag">Experimental</span> JS types like `JSAny` have
  [new compiler-specific representation types][52687].
* <span class="tag-label experimental-tag">Experimental</span> User-defined `@staticInterop` classes can
  [no longer implement `JSAny` or `JSObject`][52687].
  Usages should be migrated to `JSObject.fromInteropObject` or
  be defined as extension types.
* <span class="tag-label experimental-tag">Experimental</span> `JSArray` and `JSPromise` now have generic parameters.
* <span class="tag-label experimental-tag">Experimental</span> Various extension members were moved or renamed.
  To learn about the updated extensions, reference
  `JSAnyUtilityExtension` and `JSAnyOperatorExtension`.

[52687]: https://github.com/dart-lang/sdk/issues/52687

#### `dart:typed_data`

* [The unmodifiable view classes for typed data will
  be deprecated in Dart 3.4][53128].
  Instead of using the constructors of these classes, use
  the new `asUnmodifiableView` methods on typed data lists.

[53128]: https://github.com/dart-lang/sdk/issues/53218

#### `dart:nativewrappers`

* <span class="tag-label experimental-tag">Experimental</span> [All native wrapper classes are now marked `base`][51896]
  so that none of their subtypes can be implemented.

[51896]: https://github.com/dart-lang/sdk/issues/51896

### Tools

#### Production JavaScript compiler (dart2js)

* [The `Invocation` that is passed to `noSuchMethod` no longer
  has a minified `memberName`][54201], even when compiled with `--minify`.

[54201]: https://github.com/dart-lang/sdk/issues/54201

#### Wasm compiler (dart2wasm)

* <span class="tag-label experimental-tag">Experimental</span> [Disallow importing legacy JS interop libraries][54004].
  Prefer using `dart:js_interop` and `dart:js_interop_unsafe` instead.

[54004]: https://github.com/dart-lang/sdk/issues/54004

#### Analyzer

* <span class="tag-label experimental-tag">Experimental</span> Invalid `dart doc` comment directives are
  now reported by the analyzer.
* Due to [improvements in type promotion][54056], the following analyzer
  diagnostics might trigger on existing code that previously passed analysis:

  * `unnecessary_non_null_assertion`
  * `unnecessary_cast`
  * `invalid_null_aware_operator`

[54056]: https://github.com/dart-lang/sdk/issues/54056

#### Linter

* The `iterable_contains_unrelated_type` and
  `list_remove_unrelated_type` lints were removed.
  Consider migrating to the expanded
  [`collection_methods_unrelated_type`][] lint.
* The following lints are removed due to no longer being
  necessary with sound null safety. You should remove configuration of them
  from your `analysis_options.yaml` files and any ignore comments.
  
  * `always_require_non_null_named_parameters`
  * `avoid_returning_null`
  * `avoid_returning_null_for_future`

[`collection_methods_unrelated_type`]: /tools/linter-rules/collection_methods_unrelated_type

## 3.2.0

### Language

* <span class="tag-label language-versioned-tag">Language versioned</span> [Changed the split point for refutable patterns][53167]
  to the top level pattern so type promotion in if-case statements is consistent
  regardless of whether the scrutinee might throw an exception.

### Libraries

#### `dart:cli`

* <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label deprecated-tag">Deprecated</span> [The `waitFor` function.][52121]

#### `dart:convert`

* [Changed return types of `utf8.encode()` and `Utf8Codec.encode()`][52801]
 from `List<int>` to `Uint8List`.

#### `dart:developer`

* <span class="tag-label deprecated-tag">Deprecated</span> The `Service.getIsolateID` method.

#### `dart:ffi`

* [Changed `NativeCallable.nativeFunction` so calls now throw an error if
  the receiver is already closed][53311], instead of returning `nullptr`.

#### `dart:io`

* [Eliminated trailing whitespace from HTTP headers][53005].
* [Inserted a space at the fold point of folded header values][53227]
  that `HttpClientResponse.headers` and `HttpRequest.headers` return.

#### `dart:js_interop`

* <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label removed-tag">Removed</span> `JSNumber.toDart` in favor of `toDartDouble` and
  `toDartInt`.
* <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label removed-tag">Removed</span> `Object.toJS` in favor of `Object.toJSBox.`
* <span class="tag-label experimental-tag">Experimental</span> Restricted external JS interop APIs using `dart:js_interop`
  to a set of allowed types.
* <span class="tag-label experimental-tag">Experimental</span> Prohibited use of `isNull` and `isUndefined` on dart2wasm.
* <span class="tag-label experimental-tag">Experimental</span> Changed `typeofEquals` and `instanceof` APIs to both return
  bool instead of `JSBoolean`.
  Also, `typeofEquals` now takes `String` instead of `JSString`.
* <span class="tag-label experimental-tag">Experimental</span> Changed `JSAny` and `JSObject` types to only implementable,
  not extendable, by user `@staticInterop` types.
* <span class="tag-label experimental-tag">Experimental</span> Changed `JSArray.withLength` to take `int` instead of `JSNumber`.

### Tools

#### Development JavaScript compiler (DDC)

* [Added interceptors for JavaScript `Symbol` and `BigInt` types][53106];
  they should no longer be used with `package:js` classes.

#### Production JavaScript compiler (dart2js)

* [Added interceptors for JavaScript `Symbol` and `BigInt` types][53106];
  they should no longer be used with `package:js` classes.

#### Analyzer

* <span class="tag-label language-versioned-tag">Language versioned</span> [Private final field promotion][2020] might cause the following
  analyzer warnings to trigger on existing code that previously passed analysis:
  
  * [`unnecessary_non_null_assertion`](/tools/diagnostics/unnecessary_non_null_assertion)
  * [`invalid_null_aware_operator`](/tools/diagnostics/invalid_null_aware_operator)
  * [`unnecessary_cast`](/tools/diagnostics/unnecessary_cast)

  ```dart
  class C {
    final num? _x = null;

    void test() {
      if (_x != null) {
        print(_x! * 2); // unnecessary_non_null_assertion
        print(_x?.abs()); // invalid_null_aware_operator
      }
      if (_x is int) {
        print((_x as int).bitLength); // unnecessary_cast
      }
    }
  }
  ```

[53167]: https://github.com/dart-lang/sdk/issues/53167
[52121]: https://github.com/dart-lang/sdk/issues/52121
[52801]: https://github.com/dart-lang/sdk/issues/52801
[53311]: https://github.com/dart-lang/sdk/issues/53311
[53005]: https://github.com/dart-lang/sdk/issues/53005
[53227]: https://github.com/dart-lang/sdk/issues/53227
[53106]: https://github.com/dart-lang/sdk/issues/53106
[2020]: https://github.com/dart-lang/language/issues/2020


## 3.1.0

### Libraries

#### `dart:async`

* [Added `interface` modifier to purely abstract classes:][52334]
 `MultiStreamController`, `StreamConsumer`, `StreamIterator` and `StreamTransformer`.

#### `dart:io`

* [Added `sameSite` to the `Cookie` class, and added the class `SameSite`][51486].
* [`FileSystemEvent` is `sealed`][52027]. This means `FileSystemEvent` cannot be 
  extended or implemented.

#### `dart:js_interop`

* <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label removed-tag">Removed</span> `ObjectLiteral`; create an object literal with
  no named members using `{}.jsify()`.

#### `package:js`

* `external` `@staticInterop` members and `external` extension members can no
  longer be used as tear-offs. Declare a closure or a non-`external` method that
  calls these members, and use that instead.
* `external` `@staticInterop` members and `external` extension members will
  generate slightly different JS code for methods that have optional parameters.

[52334]: https://github.com/dart-lang/sdk/issues/52334
[51486]: https://github.com/dart-lang/sdk/issues/51486
[52027]: https://github.com/dart-lang/sdk/issues/52027

## 3.0.0

:::tip
The [Dart 3.0 migration guide][dart3] covers the complete details
on all the changes in this section.
:::

### Language

* <span class="tag-label language-versioned-tag">Language versioned</span> Changed interpretation of [switch cases] from constant
  expressions to patterns.

* <span class="tag-label language-versioned-tag">Language versioned</span> Class declarations from libraries that have been upgraded
  to Dart 3.0 [can no longer be used as mixins by default][mixin class].

* [Dart reports a compile-time error][50902] if a `continue` statement targets
  a [label] that is not a loop (`for`, `do` and `while` statements) or a `switch`
  member.

### Libraries

* The following existing classes have been made mixin classes:
  `Iterable`, `IterableMixin`, `IterableBase`, `ListMixin`, `SetMixin`, `MapMixin`,
  `LinkedListEntry`, `StringConversionSink`.

#### `dart:core`

* <span class="tag-label deprecated-tag">Deprecated</span> [Deprecated APIs][49529].

#### `dart:async`

* <span class="tag-label removed-tag">Removed</span> [Removed the deprecated][49529] [`DeferredLibrary`][] class.

#### `dart:collection`

* <span class="tag-label language-versioned-tag">Language versioned</span> [Changes to platform libraries][collection].

#### `dart:developer`

* <span class="tag-label removed-tag">Removed</span> [Removed the deprecated][49529] [`MAX_USER_TAGS`][] constant.
  Use [`maxUserTags`][] instead.
* <span class="tag-label removed-tag">Removed</span> [Removed the deprecated][50231] [`Metrics`][], [`Metric`][], [`Counter`][],
  and [`Gauge`][] classes as they have been broken since Dart 2.0.

#### `dart:ffi`

* <span class="tag-label experimental-tag">Experimental</span> <span class="tag-label deprecated-tag">Deprecated</span> The `@FfiNative` annotation is
  now deprecated. Usages should be updated to use the `@Native` annotation.

#### `dart:html`

* <span class="tag-label removed-tag">Removed</span> [Removed the deprecated `registerElement` and `registerElement2`][49536]
  methods in `Document` and `HtmlDocument`.

#### `dart:math`

* <span class="tag-label language-versioned-tag">Language versioned</span> The `Random` interface can only be implemented,
  not extended.

#### `dart:io`

* [Updated `NetworkProfiling`][51035] to accommodate new `String` ids that are
  introduced in vm_service:11.0.0

[dart3]: /resources/dart-3-migration/
[switch cases]: /language/branches#switch
[mixin class]: /language/mixins#class-mixin-or-mixin-class
[label]: /language/branches#switch
[50902]: https://github.com/dart-lang/sdk/issues/50902
[collection]: /resources/dart-3-migration#dart-collection
[49529]: https://github.com/dart-lang/sdk/issues/49529
[`DeferredLibrary`]: https://api.dart.dev/stable/2.18.4/dart-async/DeferredLibrary-class.html
[`deferred as`]: /language/libraries#lazily-loading-a-library
[`MAX_USER_TAGS`]: https://api.dart.dev/stable/dart-developer/UserTag/MAX_USER_TAGS-constant.html
[`maxUserTags`]: https://api.dart.dev/dart-developer/UserTag/maxUserTags-constant.html
[50231]: https://github.com/dart-lang/sdk/issues/50231
[`Metrics`]: https://api.dart.dev/stable/2.18.2/dart-developer/Metrics-class.html
[`Metric`]: https://api.dart.dev/stable/2.18.2/dart-developer/Metric-class.html
[`Counter`]: https://api.dart.dev/stable/2.18.2/dart-developer/Counter-class.html
[`Gauge`]: https://api.dart.dev/stable/2.18.2/dart-developer/Gauge-class.html
[49536]: https://github.com/dart-lang/sdk/issues/49536
[51035]: https://github.com/dart-lang/sdk/issues/51035


## 2.19.0

### Language

* [Flagged additional code as unreachable][49635] due to types `Null` and `Never`.
* [Don't delegate inaccessible private names to `noSuchMethod`][49687].
* [Report a compile-time error][50383] for all cyclic dependencies during
  top-level type inference.

### Libraries

#### `dart:convert`

* <span class="tag-label removed-tag">Removed</span> [The previously deprecated API][34233] [`DEFAULT_BUFFER_SIZE`] in `JsonUtf8Encoder`
  has been removed.

#### `dart:developer`

* <span class="tag-label removed-tag">Removed</span> [Removed previously deprecated APIs][34233] `kInvalidParams`,
  `kExtensionError`, `kExtensionErrorMax`, and `kExtensionErrorMin` in
  [`ServiceExtensionResponse`].

#### `dart:ffi`

* [Changed the runtime type argument of `Pointer` to `Never`][49935] in
  preparation of completely removing the runtime type argument. 
  Changed `Pointer.toString` to not report any type argument.

#### `dart:io`

* [Disallow negative or hexadecimal content-length headers][49305].
* [`File.create` now takes new optional `exclusive` `bool` parameter][49647],
  and when it is `true` the operation will fail if target file already exists.
* Calling `ResourceHandle.toFile()`, `ResourceHandle.toSocket()`,
  `ResourceHandle.toRawSocket()` or `ResourceHandle.toRawDatagramSocket()`,
  more than once [now throws a `StateError`][49878].

#### `dart:isolate`

* Reverted [`SendPort.send`] back to strict checks on contents of messages when
  sending messages between isolates that are not known to share the same code.

#### `dart:mirrors`

* <span class="tag-label removed-tag">Removed</span> [Removed APIs][34233] `MirrorsUsed` and `Comment`.

#### `package:js`

* Breaking changes to the preview feature `@staticInterop`:
  * Disallowed classes with this annotation from using `external`
    generative constructors. See [48730] and [49941] for more details.
  * [Disallowed classes with this annotation's external extension members from
    using type parameters][49350].
  * Classes with this annotation should also have the `@JS` annotation.
  * Classes with this annotation can not be implemented by classes without this
    annotation.

#### `dart2js`

* [`dart2js` no longer supports HTTP URIs as inputs][49473].

[49635]: https://github.com/dart-lang/sdk/issues/49635
[49687]: https://github.com/dart-lang/sdk/issues/49687
[50383]: https://github.com/dart-lang/sdk/issues/50383
[34233]: https://github.com/dart-lang/sdk/issues/34233
[`ServiceExtensionResponse`]: https://api.dart.dev/stable/2.17.6/dart-developer/ServiceExtensionResponse-class.html#constants
[49935]: https://github.com/dart-lang/sdk/issues/49935
[49305]: https://github.com/dart-lang/sdk/issues/49305
[49647]: https://github.com/dart-lang/sdk/issues/49647
[49878]: https://github.com/dart-lang/sdk/issues/49878
[`SendPort.send`]: https://api.dart.dev/stable/dart-isolate/SendPort/send.html
[34233]: https://github.com/dart-lang/sdk/issues/34233
[49473]: https://github.com/dart-lang/sdk/issues/49473
[48730]: https://github.com/dart-lang/sdk/issues/48730
[49941]: https://github.com/dart-lang/sdk/issues/49941
[49350]: https://github.com/dart-lang/sdk/issues/49350


## 2.18.0

### Language

* [Removed support for mixin of classes that don't extend `Object`][48167].

### Libraries

#### `dart:io`

* [Changed the `uri` property of `RedirectException` in `dart:io` to be nullable][49045].
* [Removed constants in `dart:io` networking APIs following the `SCREAMING_CAPS`
  convention][34218].
* [The Dart VM no longer automatically restores the initial terminal settings][45630]
  upon exit.

### Tools

* [Fully discontinued the `.packages` file][48272]. 

#### Dart command line

* [Removed the standalone `dart2js` and `dartdevc` tools][46100].
* [Removed the standalone `dartanalyzer` tool][46100].

[48167]: https://github.com/dart-lang/sdk/issues/48167
[49045]: https://github.com/dart-lang/sdk/issues/49045
[34218]: https://github.com/dart-lang/sdk/issues/34218
[45630]: https://github.com/dart-lang/sdk/issues/45630
[48272]: https://github.com/dart-lang/sdk/issues/48272
[46100]: https://github.com/dart-lang/sdk/issues/46100

## 2.17.0

### Libraries

#### `dart:io`

* [Added new `connectionFactory` property to `HttpClient`][47887].
* [Added new `keyLog` property to `HttpClient`][48093], which allows TLS keys to
  be logged for debugging purposes.
* [Removed constants in `dart:io` following the `SCREAMING_CAPS`][34218]
* [Added a new `allowLegacyUnsafeRenegotiation` property to `SecurityContext`][48513],
  which allows TLS renegotiation for client secure sockets.

### Tools

#### Dart command line

* <span class="tag-label deprecated-tag">Deprecated</span> [Deprecated the standalone `dart2js` tool][46100].
* <span class="tag-label deprecated-tag">Deprecated</span> [Deprecated the standalone `dartdevc` tool][46100].
* <span class="tag-label removed-tag">Removed</span> [Removed the standalone `dartdoc` tool][46100].

[47887]: https://github.com/dart-lang/sdk/issues/47887
[48093]: https://github.com/dart-lang/sdk/issues/48093
[34218]: https://github.com/dart-lang/sdk/issues/34218
[48513]: https://github.com/dart-lang/sdk/issues/48513
[46100]: https://github.com/dart-lang/sdk/issues/46100

## 2.16.0

### Libraries

#### `dart:io`

* On Windows, [`Directory.rename` will no longer delete a directory][47653] if
  `newPath` specifies one. Instead, a `FileSystemException` will be thrown.
* <span class="tag-label removed-tag">Removed</span> [Removed the `Platform.packageRoot` API][47769].

#### `dart:isolate`

* <span class="tag-label removed-tag">Removed</span> [Removed the `Isolate.packageRoot` API][47769].

### Tools

#### Dart command line

* <span class="tag-label deprecated-tag">Deprecated</span> [Deprecated the standalone `dartanalyzer` tool][46100].
* <span class="tag-label deprecated-tag">Deprecated</span> [Deprecated the standalone `dartdoc` tool][46100].
* <span class="tag-label removed-tag">Removed</span> [Removed the deprecated standalone `pub` tool][46100].

[47653]: https://github.com/dart-lang/sdk/issues/47653
[47769]: https://github.com/dart-lang/sdk/issues/47769
[46100]: https://github.com/dart-lang/sdk/issues/46100

## 2.15.0

### Libraries

#### `dart:io`

* [Updated the `SecurityContext` class][46875] to set the minimum
  TLS protocol version to TLS1_2_VERSION (1.2) instead of TLS1_VERSION.

#### `dart:web_sql`

* [Completely deleted the `dart:web_sql` library][46316].

#### `dart:html`

* [Removed `window.openDatabase`][46316] (related to `dart:web_sql` deletion above).

### Tools

#### Dart command line

* [Removed the standalone `dart2native` tool][46100].
* Removed the standalone `dartfmt` tool.

#### Dart VM

* [Removed support for `dart-ext:`-style native extensions][45451]
* [Grouped isolates spawned via the `Isolate.spawn()` API][46754] to operate on the
  same managed heap, and therefore share various VM-internal data structures.

[46875]: https://github.com/dart-lang/sdk/issues/46875
[46316]: https://github.com/dart-lang/sdk/issues/46316
[45451]: https://github.com/dart-lang/sdk/issues/45451
[46754]: https://github.com/dart-lang/sdk/issues/46754

## 2.14.0

### Libraries

#### `dart:io`

* The setter callbacks `.authenticate` and `.authenticateProxy` in `HttpClient`
  must now accept a nullable `realm` argument (for pre-migrated null safe code).

#### `dart:typed_data`

* Most types exposed by this library [can no longer be extended, implemented or
  mixed-in][45115].

### Tools

#### Dart VM

* Expandos, and the `object` parameters of `Dart_NewWeakPersistentHandle` and 
  `Dart_NewFinalizableHandle`, [no longer accept `Pointer` and subtypes of `Struct`][45071] 

#### Dart command line

* [Deprecated the standalone `dart2native` tool][46100]
* Deprecated the standalone `dartfmt` tool.

#### `dart2js`

* [`dart2js` no longer supports legacy browsers][46545], because it emits ES6+
  JavaScript by default.

#### Dart Dev Compiler (DDC)

* [Changed subtyping relations of `package:js` classes][44154] to be more correct and
  consistent with Dart2JS.

[45115]: https://github.com/dart-lang/sdk/issues/45115
[45071]: https://github.com/dart-lang/sdk/issues/45071
[46545]: https://github.com/dart-lang/sdk/issues/46545
[44154]: https://github.com/dart-lang/sdk/issues/44154


## 2.13.0

### Libraries

#### `package:js`

* [No longer valid][44211] to use a `String` that matches an `@Native` annotation
  in an `@JS()` annotation for a non-anonymous JS interop class.

[44211]: https://github.com/dart-lang/sdk/issues/44211

## 2.12.0

### Language

* [Null safety] is now enabled by default in all code that
  has not opted out.
* [Fixed an implementation bug][44660] where `this` would sometimes undergo type
  promotion in extensions.

### Libraries

#### `dart:ffi`

* [Deprecated invocations with a generic `T`][44621] of `sizeOf<T>`,
  `Pointer<T>.elementAt()`, `Pointer<T extends Struct>.ref`, and
  `Pointer<T extends Struct>[]`
* [Deprecated `allocate` in `package:ffi`][44621], as it will no longer be
  able to invoke `sizeOf<T>` generically.
* [Deprecated subtypes of `Struct` without any native member][44622].

### Tools

#### Dart VM

* [`Dart_WeakPersistentHandle` no longer auto-deletes itself][42312] when the
  referenced object is garbage collected to avoid race conditions.
* [Renamed `Dart_WeakPersistentHandleFinalizer` to `Dart_HandleFinalizer`][42312] 
  and removed its `handle` argument.

#### Pub 

* [The Dart SDK constraint is now **required** in `pubspec.yaml`][44072].

[Null safety]: /null-safety/understanding-null-safety
[44660]: https://github.com/dart-lang/sdk/issues/44660
[44621]: https://github.com/dart-lang/sdk/issues/44621
[42312]: https://github.com/dart-lang/sdk/issues/42312
[44622]: https://github.com/dart-lang/sdk/issues/44622
[44072]: https://github.com/dart-lang/sdk/issues/44072

## 2.10.0

### Tools

#### Dart VM

* [Renamed `dart_api_dl.cc` to `dart_api_dl.c`][42982] and changed to a pure C file.

[42982]: https://github.com/dart-lang/sdk/issues/42982

## 2.9.0

### Libraries

#### `dart:convert`

* When encoding a string containing unpaired surrogates as UTF-8, [the unpaired
  surrogates will be encoded as replacement characters][41100] (`U+FFFD`).
* When decoding UTF-8, [encoded surrogates will be treated as malformed input][41100].
* [Changed the number of replacement characters emitted][41100] for malformed
  input sequences to match the [WHATWG encoding standard][] when decoding UTF-8
  with `allowMalformed: true`.

#### `dart:html`

* `CssClassSet.add()` and `CssClassSet.toggle` now return `false` instead of
   `null` if the `CssClassSet` corresponds to multiple elements. 

#### `dart:mirrors`

* [Web compilers (dart2js and DDC) now produce a compile-time error][42714] if
  `dart:mirrors` is imported.

### Tools

#### Dart VM

* When printing a string using the `print` function, [the default implementation
  will print any unpaired surrogates in the string as replacement characters][41100]
  (`U+FFFD`).
* The `Dart_StringToUTF8` function in the Dart API [will convert unpaired
  surrogates into replacement characters][41100].


[41100]: https://github.com/dart-lang/sdk/issues/41100
[whatwg encoding standard]: https://encoding.spec.whatwg.org/#utf-8-decoder
[42714]: https://github.com/dart-lang/sdk/issues/42714

## 2.8.1

### Language

* [Fixed an implementation bug][40675] where local variable inference would
  incorrectly use the promoted type of a type variable.
* [Fixed an implementation bug][41362] surrounding the clauses
  `implements Function`, `extends Function`, or `with Function` no longer having
  an effect since Dart 2.0.0.

### Libraries

#### `dart:async`

* [Changed the return type of `StreamSubscription.cancel()` to `Future<void>`][40676].
* [Split the `runZoned()` function into two functions][40681]:
  `runZoned()` and `runZonedGuarded()`, where the latter has a
  required `onError` parameter, and the former has none.
* Errors passed to `Completer.completeError()`, `Stream.addError()`,
  `Future.error()`, etc. [can no longer be `null`][40683].
* [Made stack traces non-null ][40130].

#### `dart:core`

* Three members on `RuneIterator` [no longer return `null`][40674] when accessed
  before the first call to `moveNext()`.
* The `String.fromEnvironment()` default value for `defaultValue` 
  [is now an empty string instead of `null`][40678].
* The default value for `int.fromEnvironment()`'s `defaultValue` parameter
  [is now zero][40678].

#### `dart:ffi`

* Changed `Pointer.asFunction()` and `DynamicLibrary.lookupFunction()` to
  extension methods.

#### `dart:io`

* [Changed the signature of `HttpHeaders` methods][33501] `add()` and `set`.
* [The `Socket` class now throws a `SocketException`][40702] if the socket has
  been explicitly destroyed or upgraded to a secure socket upon setting or getting socket options.
* [The `Process` class now throws a `StateError`][40483]
  if the process is detached (`ProcessStartMode.detached` and
  `ProcessStartMode.detachedWithStdio`) upon accessing the `exitCode` getter.
* [The `Process` class now also throws][40483] when not connected to the child
  process's stdio (`ProcessStartMode.detached` and `ProcessStartMode.inheritStdio`) upon accessing the `stdin`, `stdout`, and `stderr` getters.
* The dummy object returned if `FileStat.stat()` or `FileStat.statSync()` fail
  [now contains Unix epoch timestamps][40706] instead of `null` for the `accessed`,
  `changed`, and `modified` getters.
* [The `HeaderValue` class now parses more strictly][40709] in two invalid edge cases.

### Tools

#### Dart Dev Compiler (DDC)

We fixed several inconsistencies between DDC and Dart2JS so that users less
frequently encounter code that is accepted by one compiler but then fails in the
other.

* Deleted the legacy (analyzer based) version of [DDC][ddc].
* Functions passed to JavaScript using the recommended `package:js` interop
  specification must now be wrapped with a call to `allowInterop`. 
* Constructors in `@JS()` classes must be marked with `external`.

#### `dart2js`

* Corresponding type parameter bounds now only need to be mutual
  subtypes rather than structurally equal up to renaming of bound type variables
  and equating all top types.
* Types are now [normalized].
* Constructors in `@JS()` classes must be marked with `external`.
* Completely removed the `--package-root` flag, which was hidden and disabled
  in Dart 2.0.0.

[40675]: https://github.com/dart-lang/sdk/issues/40675
[41362]: https://github.com/dart-lang/sdk/issues/41362
[40676]: https://github.com/dart-lang/sdk/issues/40676
[40681]: https://github.com/dart-lang/sdk/issues/40681
[40683]: https://github.com/dart-lang/sdk/issues/40683
[40130]: https://github.com/dart-lang/sdk/issues/40130
[40674]: https://github.com/dart-lang/sdk/issues/40674
[40678]: https://github.com/dart-lang/sdk/issues/40678
[33501]: https://github.com/dart-lang/sdk/issues/33501
[40702]: https://github.com/dart-lang/sdk/issues/40702
[40483]: https://github.com/dart-lang/sdk/issues/40483
[40706]: https://github.com/dart-lang/sdk/issues/40706
[40709]: https://github.com/dart-lang/sdk/issues/40709
[ddc]: https://github.com/dart-lang/sdk/issues/38994
[normalized]: https://github.com/dart-lang/language/blob/main/resources/type-system/normalization.md

## 2.7.1

* [The Dart SDK for macOS is now only available for x64][39810].

[39810]: https://github.com/dart-lang/sdk/issues/39810

## 2.7.0

### Language

* [Static extension members are accessible when imported with a prefix][671].

### Libraries

#### `dart:io`

* Added `IOOverrides.serverSocketBind` to aid in writing tests that wish to mock
  `ServerSocket.bind`.

## 2.6.0

### Language

* [Changed inference when using `Null` values in a `FutureOr` context][37985].
  Namely, constraints of the forms similar to `Null` <: `FutureOr<T>` now yield
  `Null` as the solution for `T`.

### Libraries

#### `dart:ffi`

* The API now makes use of static extension members. 
* Removed memory management `Pointer.allocate` and `Pointer.free`.
* `Pointer.offsetBy` was removed, use `cast` and `elementAt` instead.

[671]: https://github.com/dart-lang/language/issues/671
[37985]: https://github.com/dart-lang/sdk/issues/37985

## 2.5.0

### Libraries

* Various methods and properties across various core libraries, which used
  to declare a return type of `List<int>`, were [updated to declare a return type
  of `Uint8List`][36900].

#### `dart:io`

* The `Cookie` class's constructor's `name` and `value` optional positional
  parameters [are now mandatory][37192].
* [The `Cookie` class's `name` and `value` setters now validate][37192]
  that the strings are made from the allowed character set and are not null.

### Tools

#### Pub

* Packages published to [pub.dev](https://pub.dev) [can no longer contain git
  dependencies][36765].

[36900]: https://github.com/dart-lang/sdk/issues/36900
[37192]: https://github.com/dart-lang/sdk/issues/37192
[37192]: https://github.com/dart-lang/sdk/issues/37192
[36765]: https://github.com/dart-lang/sdk/issues/36765

## 2.4.0

### Language

* [Covariance of type variables used in super-interfaces is now enforced][35097]. 

### Libraries

#### `dart:isolate`

* `Isolate.resolvePackageUri` will always throw an `UnsupportedError` when
  compiled with dart2js or DDC.

#### `dart:async`

* [Fixed a bug in the `StreamIterator` class][36382] where `await for` allowed
  `null` as a stream.

[35097]: https://github.com/dart-lang/sdk/issues/35097
[36382]: https://github.com/dart-lang/sdk/issues/36382

## 2.2.0

### Libraries

#### `package:kernel`

* The `klass` getter on the `InstanceConstant` class in the
  Kernel AST API has been renamed to `classNode` for consistency.
* [Updated `Link` implementation][33966] to utilize true symbolic
  links instead of junctions on Windows.

[33966]: https://github.com/dart-lang/sdk/issues/33966

## 2.1.1

### Libraries

#### `dart:io`

* [Added to a closed `IOSink` now throws a `StateError`][29554].

[29554]: https://github.com/dart-lang/sdk/issues/29554

### Tools

#### Dart VM

* [Fixed a soundness hole when using `dart:mirrors`][35611] to reflectively
  invoke a method in an incorrect way that violates its static types.

[29554]: https://github.com/dart-lang/sdk/issues/29554
[35611]: https://github.com/dart-lang/sdk/issues/35611

## 2.1.0

### Language

* A number of static errors that should have been detected
  and reported were not supported in 2.0.0. These are reported now, which means
  existing incorrect code might show new errors:
  * [Mixins must correctly override their superclasses][34235].
  * [Implicit type arguments in extends clauses must satisfy the class bounds][34532].
  * [Instance members should shadow prefixes][34498].
  * [Constructor invocations must use valid syntax, even with optional `new`][34403].
  * [Type arguments to generic typedefs must satisfy their bounds][33308].
  * [Classes can't implement FutureOr][33744].
  * [Abstract methods may not unsoundly override a concrete method][32014].
  * [Constant constructors cannot redirect to non-constant constructors][34161].
  * [Setters with the same name as the enclosing class aren't allowed][34225].

### Tools

#### `dart2js`

* Duplicate keys in a const map are not allowed and produce a compile-time error.

[32014]: https://github.com/dart-lang/sdk/issues/32014
[33308]: https://github.com/dart-lang/sdk/issues/33308
[33744]: https://github.com/dart-lang/sdk/issues/33744
[34161]: https://github.com/dart-lang/sdk/issues/34161
[34225]: https://github.com/dart-lang/sdk/issues/34225
[34235]: https://github.com/dart-lang/sdk/issues/34235
[34403]: https://github.com/dart-lang/sdk/issues/34403
[34498]: https://github.com/dart-lang/sdk/issues/34498
[34532]: https://github.com/dart-lang/sdk/issues/34532

## 2.0.0

### Language

* Replaced the unsound optional static type system with a sound static type
  system using type inference and runtime checks, formerly called [strong mode].
* [Functions marked `async` now run synchronously][30345] until the first
  `await` statement.

### Libraries

* Renamed constants in the core libraries from `SCREAMING_CAPS` to `lowerCamelCase`.
* Added many new methods to core library classes that will need to be implemented
  if you implement the interfaces of these classes.
* `dart:isolate` and `dart:mirrors` are no longer supported when
  using Dart for the web.

### Tools

#### Pub

* Replaced pub's transformer-based build system with a [new build system][build system].

[30345]: https://github.com/dart-lang/sdk/issues/30345
[strong mode]: /language/type-system
[build system]: https://github.com/dart-lang/build

