Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

More emphasis on dart:js to JS Interop page notice #51075

Open
MaryaBelanger opened this issue Jan 19, 2023 · 0 comments
Open

More emphasis on dart:js to JS Interop page notice #51075

MaryaBelanger opened this issue Jan 19, 2023 · 0 comments
Labels
area-web Use area-web for Dart web related issues, including the DDC and dart2js compilers and JS interop. type-documentation A request to add or improve documentation web-libraries Issues impacting dart:html, etc., libraries

Comments

@MaryaBelanger
Copy link
Contributor

/// You should usually use `package:js` instead of this library. For more

Isn't dart:js is essentially deprecated / soft deprecated? If people really shouldn't be using it at all, the wording "you should usually..." needs to be a little more direct. (sparked from this related comment)

If there are specific use cases that only dart:js can address, that will not be addressed by the JS Interop updates coming up in the next couple releases, then those should be clearly listed at the top. I'm imagining something like:

dart:js interop functionality has mostly been replaced by the package:js library. Use package:js for JavaScript interop, unless you want to .... (list of things only dart:js can do)

@a-siva a-siva added area-web Use area-web for Dart web related issues, including the DDC and dart2js compilers and JS interop. type-documentation A request to add or improve documentation labels Jan 19, 2023
@joshualitt joshualitt added the web-libraries Issues impacting dart:html, etc., libraries label Jan 20, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area-web Use area-web for Dart web related issues, including the DDC and dart2js compilers and JS interop. type-documentation A request to add or improve documentation web-libraries Issues impacting dart:html, etc., libraries
Projects
None yet
Development

No branches or pull requests

3 participants