Find a file
Nate Bosch 6f5a23f150 Expand docs around error zones
Mention error zones in the docs for `runZoned`. We expect most of these
use cases to be handled by `runZonedGuarded`, but specifying an error
handler on the `ZoneSpecification` can still trigger this behavior.
Expand the phrasing from mentioning that some futures might not complete
to describe the specific reason - errors cannot cross zone boundaries
with different error zones, so specifically Futures which complete as
errors are at risk of not completing in the parent zone.

R=lrn@google.com

CoreLibraryReviewExempt: Doc changes only.
Change-Id: I8759dfb6da48463e0bb33a000943d60a4dd3d5ab
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/348043
Reviewed-by: Lasse Nielsen <lrn@google.com>
Commit-Queue: Nate Bosch <nbosch@google.com>
2024-02-29 01:49:08 +00:00
.dart_tool
.github Bump actions/upload-artifact from 4.3.0 to 4.3.1 2024-02-26 17:48:24 +00:00
benchmarks [benchmarks] Fix benchmarks warming up incorrectly. 2024-02-22 14:38:19 +00:00
build [build] Set minimum version for Windows to 10. 2024-02-23 00:22:25 +00:00
docs Update breaking-changes.md 2024-02-26 19:13:23 +00:00
pkg verify that extract_method doesn't modify macro-generated files 2024-02-29 01:01:32 +00:00
runtime [VM/Compiler] Mark instructions related to late initialization error checks as synthetic 2024-02-28 20:06:58 +00:00
samples fix use of deprecated members in ffi samples 2024-01-31 22:31:59 +00:00
sdk Expand docs around error zones 2024-02-29 01:49:08 +00:00
tests Add more information to ParalleWaitError.toString. 2024-02-28 20:36:58 +00:00
third_party [dds/dap] Add support for communicating with a DAP client using URIs instead of file paths 2024-02-27 19:10:17 +00:00
tools [dart2wasm] Update timeout value for dart2wasm tests from 4 min to 1 min 2024-02-26 13:57:19 +00:00
utils Reland "[ddc] Fix running d8 with test.py" 2024-02-13 20:09:58 +00:00
.clang-format
.gitattributes Remove the legacy "_2" tests. \o/ 2023-11-17 20:17:23 +00:00
.gitconfig
.gitignore [docs] update the messaging for dart:html and related libraries 2024-01-22 21:28:02 +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
AUTHORS Simplify the license situation 2022-09-14 21:06:22 +00:00
BUILD.gn [vm] Do not bundle dart.lib in the Dart SDK 2024-02-15 14:09:37 +00:00
CHANGELOG.md Add more information to ParalleWaitError.toString. 2024-02-28 20:36:58 +00:00
codereview.settings
CONTRIBUTING.md Update CONTRIBUTING.md 2023-11-20 09:29:37 +00:00
DEPS Update DevTools rev to 254ea4dfd93d76c6ad5e2016bf34e9057b14d9da 2024-02-28 23:32:02 +00:00
LICENSE
OWNERS Assign owners to each top level file. 2023-12-14 12:38:11 +00:00
PATENT_GRANT
PRESUBMIT.py [presubmit] first check for formatting errors in bulk. 2024-02-15 19:29:42 +00:00
README.dart-sdk Update README.dart-sdk for inclusion of AOT snapshots 2023-11-21 10:33:22 +00:00
README.md Update readme content 2023-12-18 15:30:58 +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 Fix typos 2022-06-15 11:08:28 +00:00
SECURITY.md
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 on our wiki.

Contributing to Dart

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

You can also contribute patches, as described in Contributing.