Merge pull request #516 from emberjs/NullVoxPopuli-patch-2

Update README.md for waitForFetch

Author: NullVoxPopuli

README.md

@@ -30,6 +30,7 @@ This addon implements the design specified in [RFC 581](https://github.com/ember
     - [Waiter naming conventions](#waiter-naming-conventions)
   - [waitForPromise function](#waitforpromise-function)
   - [waitFor function](#waitfor-function)
+  - [waitForFetch function](#waitforfetch-function)
   - [Waiting on all waiters](#waiting-on-all-waiters)
 - [Best Practices](#best-practices)
   - [Use buildWaiter in module scope](#use-buildwaiter-in-module-scope)
@@ -192,6 +193,25 @@ export default class Friendz extends Component {
 
 `waitFor` acts as a wrapper for the generator function, producing another generator function that is registered with the test waiter system, suitable for wrapping in an `ember-concurrency` task. So `@waitFor`/`waitFor()` needs to be applied directly to the generator function, and `@task`/`task()` applied to the result.
 
+### waitForFetch function
+
+Similar to `waitForPromise`, `waitForFetch` wraps the `fetch` promise, but also wraps the response parsing functions, `text`, `json`, etc.
+
+
+```js
+import Component from '@glimmer/component';
+import { waitForFetch } from '@ember/test-waiters';
+
+export default class MoreFriendz extends Component {
+  async funcWithAsync() {
+    let response = await waitForFetch(fetch('...'));
+
+    // automatically wrapped it waitForPromise
+    return await response.json();
+  }
+}
+```
+
 ### Waiting on all waiters
 
 The `@ember/test-waiters` addon provides a `waiter-manager` to register, unregister, iterate and invoke waiters to determine if we should wait for conditions to be met or continue test execution. This functionality is encapsulated in the `hasPendingWaiters` function, which evaluates each registered waiter to determine its current state.