Google Git
Sign in
dart / web / 3e4c60ef53dbfd0ca1996aeeca18228fe4f1b114
commit3e4c60ef53dbfd0ca1996aeeca18228fe4f1b114[log] [tgz]
authorRutvik Tak <65209850+rutvik110@users.noreply.github.com>Fri Aug 23 21:52:23 2024 +0530
committerGitHub <noreply@github.com>Fri Aug 23 09:22:23 2024 -0700
treeb68ad28949b2231435bdc60418b2e9dbf48a02e7
parent01e861efc5547cbc7802d3262ec1a99037d4b57a [diff]
[feat] Adds helpers to convert js lists to a dart list (Resolves #281) (#286)

* Made TouchListWrapper a generic JS list wrapper

* made item method on JSObject non-nullable

* docs updated

* renaming js list wrapper, docs updates

* updated JSImmutableListWrapper to receive both list type and list item type

* change JSObject extension  to an extension type of JS list, JSImmutableListWrapper updated to use new extension type

* added entry for deprecated TouchListWrapper

* deprecated TouchListConvert, removed newly added converters in favour of direct usage of JSImmutableListWrapper

* dart formatting changes

* docs updated

* removed _original parameter from JSImmutableListWrapper in favour of _jsList

* test added

* dart formatting updates

* added changelog
5 files changed
tree: b68ad28949b2231435bdc60418b2e9dbf48a02e7
  1. .github/
  2. example/
  3. lib/
  4. test/
  5. test_fixes/
  6. third_party/
  7. tool/
  8. .gitignore
  9. analysis_options.yaml
  10. CHANGELOG.md
  11. LICENSE
  12. pubspec.yaml
  13. README.md
README.md

Dart CI pub package package publisher

Lightweight browser API bindings built around JS interop.

What's this?

This package exposes browser APIs. It's generated from the Web IDL definitions and uses recent Dart language features for zero-overhead bindings.

This package is intended to replace dart:html and similar Dart SDK libraries. It will support access to browser APIs from Dart code compiled to either JavaScript or WebAssembly.

Usage

import 'package:web/web.dart';

void main() {
  final div = document.querySelector('div')!;
  div.text = 'Text set at ${DateTime.now()}';
}

Migrating to package:web

package:web is replacing dart:html and other web libraries as Dart's long-term web interop solution. To learn how to migrate from dart:html APIs to package:web, see our migration guide.

Generation conventions

The generator scripts use a number of conventions to consistently handle Web IDL definitions:

Interfaces

  • Interfaces are emitted as extension types that wrap and implement JSObject.
  • Interface inheritance is maintained using implements between extension types.
  • Members of partial interfaces, partial mixins, and mixins are added to the interfaces that include them, and therefore do not have separate declarations.

Types

  • Generic types include the generic in the case of JSArray and JSPromise.
  • Enums are typedef'd to String.
  • Callbacks and callback interfaces are typedef'd to JSFunction.
  • In general, we prefer the Dart primitive over the JS type equivalent wherever possible. For example, APIs use String instead of JSString.
  • If a type appears in a generic position and it was typedef'd to a Dart primitive type, it is replaced with the JS type equivalent to respect the type bound of JSAny?.
  • Union types are computed by picking the least upper bound of the types in the JS type hierarchy, where every interface is equivalent to JSObject.
  • Dictionary and typedef types are only emitted if they're used by another API.

Compatibility

  • The generator uses the MDN compatibility data to determine what members, interfaces, and namespaces to emit. Currently, we only emit code that is standards track and is not experimental to reduce the number of breaking changes.

Generation and updating the package

Most of the APIs in this package are generated from public assets. See tool/README.md for information on the spec and IDL versions the package was generated from, and for the process for updating the package.