JS.BASE.NO.ITERATOR

Disallow the use of the '__iterator__' property

The __iterator__ property was a SpiderMonkey extension to JavaScript that could be used to create custom iterators that are compatible with JavaScript's for in and for each constructs. However, this property is now obsolete, so it should not be used. Here's an example of how this used to work:

Copy
Foo.prototype.__iterator__ = function() {
    return new FooIterator(this);
}

You should use ECMAScript 6 iterators and generators instead.

Rule Details

This rule is aimed at preventing errors that may arise from using the __iterator__ property, which is not implemented in several browsers. As such, it will warn whenever it encounters the __iterator__ property.

Examples of incorrect code for this rule:

Copy
/*eslint no-iterator: "error"*/

Foo.prototype.__iterator__ = function() {
    return new FooIterator(this);
};

foo.__iterator__ = function () {};

foo["__iterator__"] = function () {};

Examples of correct code for this rule:

Copy
/*eslint no-iterator: "error"*/

var __iterator__ = foo; // Not using the `__iterator__` property.

The content on this page is adapted from the ESLint User Guide. Copyright © OpenJS Foundation and other contributors, www.openjsf.org. All rights reserved. https://eslint.org/docs/rules/