tree a4b77bc0b50e26967284465073fcb3051650cc82
parent 5fc5f3678ac03b28ea462101eab76305caee0eb4
author Srujan Gaddam <srujzs@google.com> 1750358786 -0700
committer Commit Queue <dart-scoped@luci-project-accounts.iam.gserviceaccount.com> 1750358786 -0700

[dart:js_interop] Clean up documentation on static vs runtime guarantees

- Make clear that you shouldn't do equality checks between a
Dart and JS value.
- Make clear you shouldn't use `is` with JS types.
- Remove mention of `as`, as that *may* be okay but is also the
only way to properly cast.

CoreLibraryReviewExempt: Doc-only change.
Change-Id: Ie4a8f22f9c44d740ddeddab55981475f0168d25e
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/434760
Reviewed-by: Ömer Ağacan <omersa@google.com>
Commit-Queue: Srujan Gaddam <srujzs@google.com>