[web libraries] Deprecate Dart web libraries

https://github.com/dart-lang/sdk/issues/59716

Deprecate dart:html, dart:svg, dart:indexed_db, dart:web_audio,
and dart:web_gl in favor of package:web and dart:js_interop.

dart:web_sql has already been deprecated and unable to be
imported.

CoreLibraryReviewExempt: JS-specific library, deprecation only.
Change-Id: I2799b474be660153318a60d5e801ecd8431b08a2
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/401045
Reviewed-by: Sigmund Cherem <sigmund@google.com>
This commit is contained in:
Srujan Gaddam
2024-12-20 11:38:57 -08:00
parent 99f879839c
commit f3b6370109
11 changed files with 44 additions and 0 deletions
+34
View File
@@ -209,6 +209,40 @@ snapshot of these tools as package build/build_web_compiler depends on it. The
AOT snapshot can be used as follows to run DDC <dart-sdk>/bin/dartaotruntime
<dart-sdk>/bin/snapshots/dartdevc_aot.dart.snapshot <options>
### Libraries
#### `dart:html`
- `dart:html` is marked deprecated and will be removed in an upcoming release.
Users should migrate to using `dart:js_interop` and `package:web`. See
[#59716][].
#### `dart:indexed_db`
- `dart:indexed_db` is marked deprecated and will be removed in an upcoming
release. Users should migrate to using `dart:js_interop` and `package:web`.
See [#59716][].
#### `dart:svg`
- `dart:svg` is marked deprecated and will be removed in an upcoming release.
Users should migrate to using `dart:js_interop` and `package:web`. See
[#59716][].
#### `dart:web_audio`
- `dart:web_audio` is marked deprecated and will be removed in an upcoming
release. Users should migrate to using `dart:js_interop` and `package:web`.
See [#59716][].
#### `dart:web_gl`
- `dart:web_gl` is marked deprecated and will be removed in an upcoming release.
Users should migrate to using `dart:js_interop` and `package:web`. See
[#59716][].
[#59716]: https://github.com/dart-lang/sdk/issues/59716
## 3.6.0
### Language
+1
View File
@@ -24,6 +24,7 @@
///
/// {@category Web (Legacy)}
/// {@canonicalFor dart:_internal.HttpStatus}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.html;
import 'dart:async';
@@ -75,6 +75,7 @@
/// documentation](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API).
///
/// {@category Web (Legacy)}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.indexed_db;
import 'dart:async';
+1
View File
@@ -15,6 +15,7 @@
/// [Scalable Vector Graphics Specification](http://www.w3.org/TR/SVG/).
///
/// {@category Web (Legacy)}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.svg;
import 'dart:async';
@@ -10,6 +10,7 @@
/// > our [migration guide](https://dart.dev/go/package-web).
///
/// {@category Web (Legacy)}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.web_audio;
import 'dart:async';
@@ -10,6 +10,7 @@
/// > our [migration guide](https://dart.dev/go/package-web).
///
/// {@category Web (Legacy)}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.web_gl;
import 'dart:async';
@@ -24,6 +24,7 @@
///
/// {@category Web (Legacy)}
/// {@canonicalFor dart:_internal.HttpStatus}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.html;
import 'dart:async';
@@ -75,6 +75,7 @@
/// documentation](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API).
///
/// {@category Web (Legacy)}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.indexed_db;
import 'dart:async';
@@ -15,6 +15,7 @@
/// [Scalable Vector Graphics Specification](http://www.w3.org/TR/SVG/).
///
/// {@category Web (Legacy)}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.svg;
import 'dart:async';
@@ -10,6 +10,7 @@
/// > our [migration guide](https://dart.dev/go/package-web).
///
/// {@category Web (Legacy)}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.web_audio;
import 'dart:async';
@@ -10,6 +10,7 @@
/// > our [migration guide](https://dart.dev/go/package-web).
///
/// {@category Web (Legacy)}
@Deprecated('Use package:web and dart:js_interop instead.')
library dart.dom.web_gl;
import 'dart:async';