Index: pkg/http/README.md |
diff --git a/pkg/http/README.md b/pkg/http/README.md |
index 81ca28630e50e2e5a1af400e8c98cf15064441ea..72466a9e2fbfe29567803dada0714a1b393b0aa3 100644 |
--- a/pkg/http/README.md |
+++ b/pkg/http/README.md |
@@ -3,15 +3,14 @@ |
A composable, Future-based library for making HTTP requests. |
This package contains a set of high-level functions and classes that make it |
-easy to consume HTTP resources. |
- |
-**NOTE:** This package currently only works for |
-server-side or command-line Dart applications. In other words, if the app |
-imports `dart:io`, it can use this package. |
+easy to consume HTTP resources. It's platform-independent, and can be used on |
+both the command-line and the browser. Currently the global utility functions |
+are unsupported on the browser; see "Using on the Browser" below. |
## Using |
-The easiest way to use this library is via the top-level functions. They allow |
+The easiest way to use this library is via the top-level functions, although |
+they currently only work on platforms where `dart:io` is available. They allow |
you to make individual HTTP requests with minimal hassle: |
```dart |
@@ -74,6 +73,25 @@ class UserAgentClient extends http.BaseClient { |
} |
``` |
+## Using on the Browser |
+ |
+The HTTP library can be used on the browser via the [BrowserClient][] class in |
+`package:http/browser_client.dart`. This client translates requests into |
+XMLHttpRequests. For example: |
+ |
+```dart |
+import 'package:http/browser_client.dart'; |
+import 'package:http/http.dart' as http; |
+ |
+var client = new BrowserClient(); |
+var url = "/whatsit/create"; |
+client.post(url, body: {"name": "doodle", "color": "blue"}) |
+ .then((response) { |
+ print("Response status: ${response.statusCode}"); |
+ print("Response body: ${response.body}"); |
+}); |
+``` |
+ |
## Filing issues |
Please file issues for the http package at [http://dartbug.com/new][bugs]. |