This article covers features introduced in SpiderMonkey js1.8
Throw a StopIteration exception.
Syntax
bool JS_ThrowStopIteration(JSContext *cx);
| Name | Type | Description |
|---|---|---|
cx |
JSContext * |
The context in which to throw the StopIteration object. |
Description
JS_ThrowStopIteration throws the appropriate StopIteration object for the function currently executing in cx.
In for…in and for each…in loops, the JavaScript engine can create an iterator object and call its .next method repeatedly, as described in New in JavaScript 1.7: Iterators. The .next method may throw StopIteration when there are no more values left to iterate. The engine automatically catches the exception and exits the loop.
JSClass.enumerate offers a simpler way to customize object iteration.