Function build

e2e/helper/jsApi.ts:179–247

({
  catchBuildError = false,
  runServer = false,
  watch = false,
  page,
  logHelper,
  ...options
}: BuildOptions = {})

 * Build the project and return the build result.
 */
export async function build({
  catchBuildError = false,
  runServer = false,
  watch = false,
  page,
  logHelper,
  ...options
}: BuildOptions = {}) {
  process.env.NODE_ENV = 'production';

  options.config = await updateConfigForTest(options.config || {}, options.cwd);

  const rsbuild = await createRsbuild(options);
  const getOutputFiles = collectOutputFiles(rsbuild);

  let buildError: Error | undefined;
  let buildResult: RsbuildBuildResult | undefined;

  try {
    buildResult = await rsbuild.build({ watch });
  } catch (error) {
    buildError = error as Error;
    buildError.message = stripAnsi(buildError.message);

    if (!catchBuildError) {
      throw buildError;
    }
  }

  const { distPath } = rsbuild.context;

  let port = 0;
  let server = { close: noop };

  if (runServer || page) {
    const result = await rsbuild.preview();
    port = result.port;
    server = result.server;
  }

  const getIndexBundle = async () => {
    const [name, content] =
      Object.entries(getOutputFiles()).find(
        ([file]) => file.includes('index') && file.endsWith('.js'),
      ) || [];
    assert(name && content);
    return content;
  };

  if (page) {
    await gotoPage(page, { port });
  }

  return {
    ...logHelper!,
    distPath,
    port,
    stats: buildResult?.stats,