کنترل جریان

از کلمه کلیدی function* (به ستاره توجه کنید) برای تعریف یک تابع مولد یا تعریف یک عبارت تابع مولد استفاده کنید:

function* myGeneratorFunction() { };

مانند تکرار کننده ها ، توابع مولد حالت را حفظ می کنند. فراخوانی یک تابع مولد یک شی Generator جدید را برمی گرداند اما بلافاصله کد را در بدنه تابع اجرا نمی کند:

function* myGeneratorFunction() {
  console.log( "Generator function body ")
};
const myGeneratorObject = myGeneratorFunction();

myGeneratorObject;
> Generator {  }

typeof myGeneratorObject;
> "object"

اشیاء ژنراتور از پروتکل تکرار کننده پیروی می کنند. مقداری که هر فراخوانی به next() در تابع مولد برمی گرداند توسط یک عبارت yield تعیین می شود که اجرای تابع مولد را متوقف می کند و مقدار عبارتی را که حاوی کلمه کلیدی yield است برمی گرداند. فراخوانی های بعدی به next() اجرای تابع را ادامه می دهد، در عبارت yield بعدی مکث می کند و مقدار مربوطه را برمی گرداند.

function* myGeneratorFunction() {
  yield "My first yielded value.";
  yield "My second yielded value.";
};
const myGeneratorObject = myGeneratorFunction();

myGeneratorObject.next();
> Object { value: "My first yielded value.", done: false }

myGeneratorObject.next();
> Object { value: "My second yielded value.", done: false }

هنگامی که next() پس از اینکه هیچ مقدار دیگری با استفاده از yield ، return یا throw (در صورت بروز خطا) مشخص نشد فراخوانی می شود، بقیه بدنه تابع اجرا می شود، و Object برگردانده شده دارای value undefined و یک ویژگی done است. true :

function* myGeneratorFunction() {
    console.log( "Start of the generator function." );
    yield "First";
    console.log( "Second part of the generator function."  );
    yield "Second";
    console.log( "Third part of the generator function." );
    yield "Third";
};
const myGeneratorObject = myGeneratorFunction();

myGeneratorObject.next();
> "Start of the generator function."
> Object { value: "First", done: false }

myGeneratorObject.next();
> "Second part of the generator function."
> Object { value: "Second", done: false }

myGeneratorObject.next();
> "Third part of the generator function."
> Object { value: "Third", done: false }

myGeneratorObject.next();
> Object { value: undefined, done: true }

next() فقط در شیء استفاده کنید که تابع مولد برمی گرداند، نه خود تابع مولد. در غیر این صورت، هر فراخوانی به تابع مولد یک شی مولد جدید ایجاد می کند:

function* myGeneratorFunction() {
  yield "First";
  yield "Second";
};

myGeneratorFunction().next();
> Object { value: "First", done: false }

myGeneratorFunction().next();
> Object { value: "First", done: false }

مانند هر تابع دیگری، عملکرد مولد هنگامی که با کلمه کلیدی return روبرو می شود متوقف می شود. سپس یک Object را به متن فراخوانی برمی گرداند که حاوی مقدار بازگشتی و یک خاصیت done با مقدار true است.

function* myGeneratorFunction() {
  yield 1;
  yield 2;
  return 3;
};
const myGeneratorObject = myGeneratorFunction();

myGeneratorObject.next().done;
> Object { value: 1, done: false }

myGeneratorObject.next().done;
> Object { value: 2, done: false }

myGeneratorObject.next();
> Object { value: 3, done: true }

یک عبارت yield می تواند برخی از معنایی یک شناسه را به خود بگیرد، و اجازه می دهد "ارتباط" دو طرفه از و بازگشت به بخش معلق تابع مولد. هنگامی که یک مقدار به عنوان آرگومان به متد next() ژنراتور ارسال می شود، مقدار مربوط به عبارت yield معلق قبلی را جایگزین می کند:

function* myGeneratorFunction() {
    const firstYield = yield;
    yield firstYield + 10;
};
const myGeneratorObject = myGeneratorFunction();

myGeneratorObject.next();
> Object { value: undefined, done: false }

myGeneratorObject.next( 5 );
> Object { value: 15, done: false }

به خاطر داشته باشید که این جایگزین کل عبارت مرتبط با yield قبلی است و فقط مقدار yield قبلی را به مقدار مشخص شده در next() تخصیص نمی دهد:

function* myGeneratorFunction() {
    const firstYield = yield;
    const secondYield = yield firstYield + 100;
    yield secondYield + 10;
};
const myGeneratorObject = myGeneratorFunction();

myGeneratorObject.next();
> Object { value: undefined, done: false }

myGeneratorObject.next( 10 ); // Can be thought of as changing the value of the `firstYield` variable to `10
> Object { value: 110, done: false }

myGeneratorObject.next( 20 ); // Can be thought of as changing the value of the `secondYield` variable to `20`, _not_ `20 + 100;`
> Object { value: 30, done: false }

هر آرگومان ارسال شده به اولین فراخوانی next() نادیده گرفته می شود، زیرا هیچ عبارت yield قبلی برای پذیرش آن مقدار وجود ندارد. مانند هر تابع دیگری، آرگومان های ارسال شده به فراخوانی تابع مولد اولیه در سراسر محدوده بدنه تابع مولد در دسترس هستند:

function* myGeneratorFunction( startingValue ) {
    let newValue = yield startingValue + 1;
    newValue = yield newValue + 10;
    yield startingValue + 20;
};
const myGeneratorObject = myGeneratorFunction( 2 );

myGeneratorObject.next( 1 );
> Object { value: 3, done: false }

myGeneratorObject.next( 5 );
> Object { value: 15, done: false }

myGeneratorObject.next( 10 );
Object { value: 22, done: false }

عملگر yield* (به ستاره توجه کنید) با یک قابل تکرار، مانند تابع مولد دیگر، برای تکرار و به دست آوردن هر مقداری که عملوند آن برمی گرداند، استفاده می شود:

function* mySecondaryGenerator() {
  yield 2;
  yield 3;
}

function* myGenerator() {
  yield 1;
  yield* mySecondaryGenerator();
  yield 4;
  return 5;
}

const myIterator = myGenerator();

myIterator.next();
> Object { value: 1, done: false }

myIterator.next();
> Object { value: 2, done: false }

myIterator.next();
> Object { value: 3, done: false }

myIterator.next();
> Object { value: 4, done: false }

myIterator.next();
> Object { value: 5, done: true }

const myPromise = new Promise( () => { });

const  myPromise = new Promise( ( fulfill, reject ) => { });

const myPromise = new Promise( ( fulfill, reject ) => {
  const myResult = true;
  setTimeout(() => {
    if( myResult === true ) {
        fulfill( "This Promise was successful." );    
    } else {
        reject( new Error( "This Promise has been rejected." ) );
    }
  }, 10000);
});

myPromise;
> Promise { <state>: "pending" }

myPromise;
> Promise { <state>: "fulfilled", <value>: "This Promise was successful." }

const myPromise = new Promise( ( fulfill, reject ) => {
  const myResult = true;
  setTimeout(() => {
    if( myResult === true ) {
        fulfill( "This Promise was fulfilled." );    
    } else {
        reject( new Error( "This Promise has been rejected." ) );
    }
  }, 100);
});

myPromise.then( successfulResult => console.log( successfulResult ), failedResult => console.error( failedResult ) );
> "This Promise was successful."

const myPromise = new Promise( ( fulfill, reject ) => {
  const myResult = false;
  setTimeout(() => {
    if( myResult === true ) {
        fulfill( "This Promise was fulfilled." );    
    } else {
        reject( new Error( "This Promise has been rejected." ) );
    }
  }, 100);
});

myPromise
  .then( fulfilledResult => console.log(fulfilledResult ) )
  .catch( rejectedResult => console.log( rejectedResult ) )
  .finally( () => console.log( "The Promise has settled." ) );
> "Error: This Promise has been rejected."
> "The Promise has settled."

const firstPromise  = new Promise( ( fulfill, reject ) => fulfill( "Successful. ") );
const secondPromise = new Promise( ( fulfill, reject ) => fulfill( "Successful. ") );
const thirdPromise  = new Promise( ( fulfill, reject ) => fulfill( "Successful. ") );
const failedPromise = new Promise( ( fulfill, reject ) => reject( "Failed.") );
const successfulPromises = [ firstPromise, secondPromise, thirdPromise ];
const  failedPromise, ...successfulPromises ];

Promise.all( successfulPromises )
  .then( ( allValues ) => {
    console.log( allValues );
  })
  .catch( ( failValue ) => {
    console.error( failValue );
  });
> Array(3) [ "Successful. ", "Successful. ", "Successful. " ]

Promise.all( oneFailedPromise  )
    .then( ( allValues ) => {
      console.log( allValues );
    })
    .catch( ( failValue ) => {
     console.error( failValue );
    });
> "Failed."

async function myFunction() {
  return "This is my returned value.";
}

myFunction().then( myReturnedValue => console.log( myReturnedValue ) );
> "This is my returned value."

async function myFunction() {
  const myPromise  = new Promise( ( fulfill, reject ) => { setTimeout( () => fulfill( "Successful. "), 5000 ); });
  const myPromisedResult = await myPromise;
  return myPromisedResult;
}

myFunction()
  .then( myResult => console.log( myResult ) )
  .catch( myFailedResult => console.error( myFailedResult ) );
> "Successful."

async function myFunction() {
  const myPromisedResult = await "String value.";
  return myPromisedResult;
}

myFunction()
  .then( myResult => console.log( myResult ) )
  .catch( myFailedResult => console.error( myFailedResult ) );
> "String value."