README.md

Dart JavaScript Interop

The js.dart library allows Dart code running in the browser to manipulate JavaScript running in the same page. It is intended to allow Dart code to easily interact with third-party JavaScript libraries.

Documentation

See API documentation.

Samples

See samples that demonstrate interaction with JavaScript code. These include interoperation with the Google Maps JavaScript library, the Google Visualization JavaScript library, and Twitter's query API via JSONP.

Usage

The Dart Editor now includes pub support. To try out this library in the editor:

1. Update to the latest editor.

2. From the "File" menu, open a "New Application" (and make sure "Add Pub support" is checked).

3. Add the following to your pubspec.yaml:

   dependencies:
     js: any
   

4. Under the "Tools" menu, run "Pub Install".

5. Try the following test Dart file:

   import 'package:js/js.dart' as js;
   
   void main() {
     js.context.alert('Hello from Dart via JS');
   }
   

Running Tests

First, use the Pub Package Manager to install dependencies:

pub install

To run browser tests on Dartium, simply open test/browser_tests.html in Dartium.

To run browser tests using JavaScript in any modern browser, first use the following command to compile to JavaScript:

dart2js -otest/browser_tests.dart.js test/browser_tests.dart

and then open test/browser_tests.html in any browser.