Interface SequentialFunction

Callable

• SequentialFunction(...args: any[]): Promise<any>

• async

  example

  // as a standalone function
  
  const process = functions.sequence();
  
  async function handler1(...args, lastHandlerResult) {
    console.log(args, lastHandlerResult);
    await someAsyncMethod(...args);
    return 1;
  }
  
  function handler2(...args, lastHandlerResult) {
    console.log(args, lastHandlerResult);
    return 2;
  }
  
  process.add(handler1);
  process.add(handler2);
  
  await process('abc', 'def'); // 2
  // output from handler1: ['abc', 'def'], undefined
  // output from handler2: ['abc', 'def'], 1
  

  example

  // as a combination event handler
  
  function handler1(...args) {
    return 'some value';
  }
  
  function handler2(...args, previousValue) {
    return previousValue === 'some value';
  }
  
  const bus = events.bus();
  
  bus.on('event', functions.sequence(handler1, handler2));
  await bus.fire('event', 'arg1', 'arg2'); // [true]
  

  Parameters

  • Rest ...args: any[]

    The arguments to pass to the original functions.

  Returns Promise<any>

  A Promise resolved with the last function's settled return value, or rejected if any function rejects or throws an error. The functions will be passed the incoming arguments along with the value returned by the previous function.