Function createTestInterface

src/test/testlib.ts:133–324

(opts: {
  titlePrefix: string | undefined;
  separator: string | undefined;
  mustDoSerial: boolean;
  automaticallyDoSerial: boolean;
  automaticallySkip: boolean;
  beforeEachFunctions: Function[];
})

}

function createTestInterface<Context>(opts: {
  titlePrefix: string | undefined;
  separator: string | undefined;
  mustDoSerial: boolean;
  automaticallyDoSerial: boolean;
  automaticallySkip: boolean;
  beforeEachFunctions: Function[];
}): TestInterface<Context> {
  const { titlePrefix, separator = ' > ' } = opts;
  const beforeEachFunctions = [...(opts.beforeEachFunctions ?? [])];
  let { mustDoSerial, automaticallyDoSerial, automaticallySkip } = opts;
  let hookDeclared = false;
  let suiteOrTestDeclared = false;
  function computeTitle<Args extends any[]>(
    title: string | undefined,
    macros?: AvaMacro<Args, any>[],
    ...args: Args
  ) {
    for (const macro of macros ?? []) {
      if (macro.title) {
        title = macro.title(title, ...args);
      }
    }
    assert(title);
    // return `${ titlePrefix }${ separator }${ title }`;
    if (titlePrefix != null && title != null) {
      return `${titlePrefix}${separator}${title}`;
    }
    if (titlePrefix == null && title != null) {
      return title;
    }
  }
  function parseArgs(args: any[]) {
    const title =
      typeof args[0] === 'string' ? (args.shift() as string) : undefined;
    const macros =
      typeof args[0] === 'function'
        ? [args.shift() as AvaMacro]
        : Array.isArray(args[0])
        ? (args.shift() as AvaMacro[])
        : [];
    return { title, macros, args };
  }
  function assertOrderingForDeclaringTest() {
    suiteOrTestDeclared = true;
  }
  function assertOrderingForDeclaringHook() {
    if (suiteOrTestDeclared) {
      throw new Error(
        'Hooks must be declared before declaring sub-suites or tests'
      );
    }
    hookDeclared = true;
  }
  function assertOrderingForDeclaringSkipUnless() {
    if (suiteOrTestDeclared) {
      throw new Error(
        'skipUnless or runIf must be declared before declaring sub-suites or tests'