Method requireModule

packages/jest-runtime/src/internals/CjsLoader.ts:63–169

(
    from: string,
    moduleName?: string,
    options?: TransformOptions,
    isRequireActual = false,
  )

  }

  requireModule<T = unknown>(
    from: string,
    moduleName?: string,
    options?: TransformOptions,
    isRequireActual = false,
  ): T {
    const isInternal = options?.isInternalModule ?? false;
    const moduleID = this.mockState.getCjsModuleId(from, moduleName);
    let modulePath: string | undefined;

    // Some old tests rely on this mocking behavior. Ideally we'll change this
    // to be more explicit.
    const moduleResource = moduleName && this.resolution.getModule(moduleName);
    const manualMock =
      moduleName && this.resolution.getCjsMockModule(from, moduleName);
    if (
      !options?.isInternalModule &&
      !isRequireActual &&
      !moduleResource &&
      manualMock &&
      manualMock !== this.executor.getCurrentlyExecutingManualMock() &&
      !this.mockState.isExplicitlyUnmocked(moduleID)
    ) {
      modulePath = manualMock;
    }

    if (moduleName && this.resolution.isCoreModule(moduleName)) {
      return this.coreModule.require(
        moduleName,
        supportsNodeColonModulePrefixInRequire,
      ) as T;
    }

    if (!modulePath) {
      modulePath = this.resolution.resolveCjs(from, moduleName);
    }

    if (this.resolution.shouldLoadAsEsm(modulePath)) {
      if (!supportsSyncEvaluate) {
        const error: NodeJS.ErrnoException = new Error(
          `Must use import to load ES Module: ${modulePath}\n` +
            "Jest's require(ESM) requires Node v24.9+ for " +
            'synchronous vm module APIs; the current Node version does not ' +
            'expose them.',
        );
        error.code = 'ERR_REQUIRE_ESM';
        throw error;
      }
      // Fast path: skip the graph walker on cache hits.
      const reg = this.registries.getActiveEsmRegistry();
      const cached = reg.get(modulePath);
      if (cached && !(cached instanceof Promise)) {
        return (cached as VMModule).namespace as T;
      }
      return this.requireEsm<T>(modulePath);
    }

    const moduleRegistry = isInternal