Iterator clarification

[pirfalt]

Your explanation is great, but I have tried to find definitive answer to what api the iterator will have. Your explanation is another example to support one of the two I have found, do you know if it is the latest? And could you make that clear in the document?

The two I have found are:

// Yours and (https://people.mozilla.org/~jorendorff/es6-draft.html#sec-common-iteration-interfaces)
var iterable = {
  [Symbol.iterator]() {
    let pre = 0, cur = 1;
    return {
      next() {
        [pre, cur] = [cur, pre + cur];
        return { done: false, value: cur }
        // alt. return { done: true, value: IteratorReturn || undefined }
      }
    }
  }
}

and

// Harmony wiki. (http://wiki.ecmascript.org/doku.php?id=harmony:iterators)
var iterable = {
  [Symbol.iterator]() {
    let pre = 0, cur = 1;
    return {
      next() {
        [pre, cur] = [cur, pre + cur];
        return cur
        // alt. throw new StopIteration()
      }
    }
  }
}

[domenic]

Everything in this repo is the latest always; the wiki is generally out of date.

The fact that this repo matches the spec, as you noted, is a clue in this regard. Plus the giant bold "This page is out of date" at the top of the wiki.

[pirfalt]

Thanks, thats really good to know. I found it very unclear where to find correct information before.

[getify]

To answer concretely, the return value will be { done: ... , value: ... }. :)