Find a file
Srujan Gaddam 1c534e5fd5 [dart2wasm/ddc/dart2js] Lower Function.toJS and JSExportedDartFunction.toDart
Lowers these extension methods to some helper functions instead of
allowInterop to improve performance and get consistent semantics.

Specifically:
- Function.toJS no longer gives you the same JSFunction when calling
toJS on the same function multiple times in the JS compilers.
- Adds fast calling syntax for functions with 0-5 args in the JS
compilers.
- Allows additional args to be passed to converted functions that
are omitted in the JS compilers.
- The static type now determines the number of args that can be
passed to the JS function in the JS compilers.
- Fixes an issue in dart2wasm where if too few arguments are
passed, the call may succeed due to conversion of undefined to
null.
- Adds throws when a user tries to wrap a JS function that
returned from Function.toJS in the JS compilers.

Closes https://github.com/dart-lang/sdk/issues/55515
Addresses https://github.com/dart-lang/sdk/issues/48186

CoreLibraryReviewExempt: Changes to docs only in API surface.
Change-Id: I41d864dc5e02b597d9f1c16c88e3c04872f28225
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/368065
Reviewed-by: Nicholas Shahan <nshahan@google.com>
Reviewed-by: Stephen Adams <sra@google.com>
Commit-Queue: Srujan Gaddam <srujzs@google.com>
Reviewed-by: Martin Kustermann <kustermann@google.com>
2024-06-26 23:06:36 +00:00
.dart_tool [infra] re-land work to auto-generate .dart_tool/package_config.json 2022-04-12 17:21:02 +00:00
.github [repo] delay issue triage by 2 minutes 2024-06-24 23:50:16 +00:00
benchmarks [benchmarks] Remove dynamic invocations in BigIntParsePrint benchmark 2024-06-26 08:07:11 +00:00
build Add 'coverage' flag, defaulting to true, but let the gn application_snapshot default it to false 2024-06-18 09:10:00 +00:00
docs [docs] Add instructions for building on Fuchsia 2024-06-25 12:59:19 +00:00
pkg [dart2wasm/ddc/dart2js] Lower Function.toJS and JSExportedDartFunction.toDart 2024-06-26 23:06:36 +00:00
runtime Revert "[ Service ] Start DDS and serve DevTools when the VM service is started via dart:developer" 2024-06-26 22:36:09 +00:00
samples [infra] Expand sanitizer test coverage. 2024-05-02 23:31:48 +00:00
sdk [dart2wasm/ddc/dart2js] Lower Function.toJS and JSExportedDartFunction.toDart 2024-06-26 23:06:36 +00:00
tests [dart2wasm/ddc/dart2js] Lower Function.toJS and JSExportedDartFunction.toDart 2024-06-26 23:06:36 +00:00
third_party [third_party] Add jsshell binaries to gitignore 2024-06-14 09:33:07 +00:00
tools [null-aware-elements] Add experiment flag 'null-aware-elements'. 2024-06-26 09:28:16 +00:00
utils Add 'coverage' flag, defaulting to true, but let the gn application_snapshot default it to false 2024-06-18 09:10:00 +00:00
.clang-format
.gitattributes Fix allowing Windows newlines in sh files. 2024-03-19 11:27:14 +00:00
.gitconfig [infra] Add documentation to .gitconfig 2018-06-11 18:24:16 +00:00
.gitignore [infra] Support testing with RBE on Windows. 2024-02-29 10:33:09 +00:00
.gn [build] Switch to Fuchsia core SDK. 2023-11-10 19:23:11 +00:00
.mailmap Fixed various typos in a lot of files 2022-07-25 12:21:59 +00:00
.style.yapf Mass format python with yapf 2019-08-05 20:34:31 +00:00
AUTHORS Simplify the license situation 2022-09-14 21:06:22 +00:00
BUILD.gn [tools] Allow precompiling gen_kernel and compile_platform 2024-05-24 09:40:39 +00:00
CHANGELOG.md [dart2wasm/ddc/dart2js] Lower Function.toJS and JSExportedDartFunction.toDart 2024-06-26 23:06:36 +00:00
codereview.settings [infra] Default presubmits to use python3 2021-08-24 08:20:47 +00:00
CONTRIBUTING.md [wiki] move the https://github.com/dart-lang/sdk/wiki to the docs/ dir 2024-05-16 18:19:40 +00:00
DEPS Roll gn from f284b6b47039 to b2afae122eeb 2024-06-26 19:52:52 +00:00
LICENSE Update LICENSE 2021-04-08 07:57:10 +00:00
OWNERS add package:_macros (SDK vendored) and package:macros (pub published) 2024-03-26 18:40:00 +00:00
PATENT_GRANT Rename patent file 2019-08-16 12:03:17 +00:00
PRESUBMIT.py [infra] Add clang-format to PRESUBMIT.py 2024-04-19 15:45:16 +00:00
README.dart-sdk Update README.dart-sdk for inclusion of AOT snapshots 2023-11-21 10:33:22 +00:00
README.md [wiki] move the https://github.com/dart-lang/sdk/wiki to the docs/ dir 2024-05-16 18:19:40 +00:00
sdk.code-workspace [cleanup] Remove co19_2 and other references to _2 suites 2023-11-22 11:15:57 +00:00
sdk_args.gni [tools] Allow precompiling gen_kernel and compile_platform 2024-05-24 09:40:39 +00:00
sdk_packages.yaml add package:_macros (SDK vendored) and package:macros (pub published) 2024-03-26 18:40:00 +00:00
SECURITY.md Add link to published advisories 2022-02-08 19:45:07 +00:00
WATCHLISTS [analyzer] Properly close analyzer WATCHLISTS entry 2023-12-10 18:02:25 +00:00

Dart

An approachable, portable, and productive language for high-quality apps on any platform

Dart is:

  • Approachable: Develop with a strongly typed programming language that is consistent, concise, and offers modern language features like null safety and patterns.

  • Portable: Compile to ARM, x64, or RISC-V machine code for mobile, desktop, and backend. Compile to JavaScript or WebAssembly for the web.

  • Productive: Make changes iteratively: use hot reload to see the result instantly in your running app. Diagnose app issues using DevTools.

Dart's flexible compiler technology lets you run Dart code in different ways, depending on your target platform and goals:

  • Dart Native: For programs targeting devices (mobile, desktop, server, and more), Dart Native includes both a Dart VM with JIT (just-in-time) compilation and an AOT (ahead-of-time) compiler for producing machine code.

  • Dart Web: For programs targeting the web, Dart Web includes both a development time compiler (dartdevc) and a production time compiler (dart2js).

Dart platforms illustration

License & patents

Dart is free and open source.

See LICENSE and PATENT_GRANT.

Using Dart

Visit dart.dev to learn more about the language, tools, and to find codelabs.

Browse pub.dev for more packages and libraries contributed by the community and the Dart team.

Our API reference documentation is published at api.dart.dev, based on the stable release. (We also publish docs from our beta and dev channels, as well as from the primary development branch).

Building Dart

If you want to build Dart yourself, here is a guide to getting the source, preparing your machine to build the SDK, and building.

There are more documents in our repo at docs.

Contributing to Dart

The easiest way to contribute to Dart is to file issues.

You can also contribute patches, as described in Contributing.

Roadmap

Future plans for Dart are included in the combined Dart and Flutter roadmap on the Flutter wiki.