# Introduction

![](https://1453685510-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_UuV4d3E2AjbbCY57m%2F-L__8NpTTrJPPpwtZmaH%2F-L__8Zhi7tZqwRUpIPXZ%2F04.png?alt=media\&token=7bac70c8-c236-48ae-baac-ba5e0d028c78)

Use `expect-to-yield` to wrap your generator object with a helper function that keeps track of each iteration and provides the expectation function `.toYieldValue(...)` to assert the expected value. When a failure happens, get access to the iteration history to figure out what is going on.

### Setup

Becoming a super hero is a fairly straight forward process:

```
$ npm install --save-dev expect-to-yield
```

### Usage

#### In your tests, wrap your iterators

```javascript
import { iteratorWithHistory as i } from 'expect-to-yield';

function* counter() {
    yield 1;
    yield 2;
    yield 3;
}
const itr = i(counter());
```

#### write your tests

```javascript
// extend expect to have `.toYieldValue(...)
import 'expect-to-yield/extend-expect';

test('the iterator works', () => {
    const itr = i(counter());
    itr.next();
    expect(itr).toYieldValue(1);
    // // this fails the test and outputs:
    // expected: 1
    // received: 2
    // history:
    // > 1: 1
    //   2: 2
    // suggestion:
    //   expect(itr).toYieldValue(1);
});
```