function*
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
function* 선언 (끝에 별표가 있는function keyword) 은generator function 을 정의하는데, 이 함수는Generator 객체를 반환합니다.
시도해 보기
function* generator(i) { yield i; yield i + 10;}const gen = generator(10);console.log(gen.next().value);// Expected output: 10console.log(gen.next().value);// Expected output: 20generator function 은GeneratorFunction 생성자와function* expression 을 사용해서 정의할 수 있습니다.
문법
function* name([param[, param[, ... param]]]) { statements }name함수명.
param함수에 전달되는 인수의 이름. 함수는 인수를 255개까지 가질 수 있다.
statements함수의 본체를 구성하는 구문들.
설명
Generator는 빠져나갔다가 나중에 다시 돌아올 수 있는 함수입니다. 이때 컨텍스트(변수 값)는 출입 과정에서 저장된 상태로 남아 있습니다.
Generator 함수는 호출되어도 즉시 실행되지 않고, 대신 함수를 위한Iterator 객체가 반환됩니다. Iterator의next() 메서드를 호출하면 Generator 함수가 실행되어yield 문을 만날 때까지 진행하고, 해당 표현식이 명시하는 Iterator로부터의 반환값을 반환합니다.yield* 표현식을 마주칠 경우, 다른 Generator 함수가 위임(delegate)되어 진행됩니다.
이후next() 메서드가 호출되면 진행이 멈췄던 위치에서부터 재실행합니다.next() 가 반환하는 객체는yield문이 반환할 값(yielded value)을 나타내는value 속성과, Generator 함수 안의 모든yield 문의 실행 여부를 표시하는 boolean 타입의done 속성을 갖습니다.next() 를 인자값과 함께 호출할 경우, 진행을 멈췄던 위치의yield 문을next() 메서드에서 받은 인자값으로 치환하고 그 위치에서 다시 실행하게 됩니다.
예시
간단한 예제
function* idMaker() { var index = 0; while (index < 3) yield index++;}var gen = idMaker();console.log(gen.next().value); // 0console.log(gen.next().value); // 1console.log(gen.next().value); // 2console.log(gen.next().value); // undefined// ...yield* 를 사용한 예제
function* anotherGenerator(i) { yield i + 1; yield i + 2; yield i + 3;}function* generator(i) { yield i; yield* anotherGenerator(i); yield i + 10;}var gen = generator(10);console.log(gen.next().value); // 10console.log(gen.next().value); // 11console.log(gen.next().value); // 12console.log(gen.next().value); // 13console.log(gen.next().value); // 20Generator 에 인자값을 넘기는 예제
function* logGenerator() { console.log(yield); console.log(yield); console.log(yield);}var gen = logGenerator();// the first call of next executes from the start of the function// until the first yield statementgen.next();gen.next("pretzel"); // pretzelgen.next("california"); // californiagen.next("mayonnaise"); // mayonnaiseGenerator 는 생성자로서 사용될 수 없다
function* f() {}var obj = new f(); // throws "TypeError: f is not a constructor"명세서
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-generator-function-definitions |
브라우저 호환성
관련 항목
function* expressionGeneratorFunctionobject- The Iterator protocol
yieldyield*Functionobjectfunction declarationfunction expressionFunctions and function scope- Other web resources:
- Regenerator an ES2015 generator compiler to ES5
- Forbes Lindesay: Promises and Generators: control flow utopia — JSConf EU 2013
- Hemanth.HM: The New gen of *gen(){}
- Task.js