usebruno/bruno · error · BrunoError

Failed to process ${parsedFile.fileName}: ${err.message}

Error message

Failed to process ${parsedFile.fileName}: ${err.message}

What it means

Per-file catch inside processFiles. Fires when processEnvironmentData throws for a single parsed file; re-wraps with that file's name so the user knows which file in a multi-file import failed.

Source

Thrown at packages/bruno-app/src/utils/importers/bruno-environment.js:71

      });
    }

    // Handle single environment object
    return [validateBrunoEnvironment(data)];
  } catch (err) {
    throw new BrunoError(`Error processing ${fileName}: ${err.message}`);
  }
};

const processFiles = (parsedFiles) => {
  const allEnvironments = [];

  for (const parsedFile of parsedFiles) {
    try {
      const environments = processEnvironmentData(parsedFile.content, parsedFile.fileName);
      allEnvironments.push(...environments);
    } catch (err) {
      throw new BrunoError(`Failed to process ${parsedFile.fileName}: ${err.message}`);
    }
  }

  return allEnvironments;
};

const importBrunoEnvironment = (parsedFiles) => {
  try {
    if (!parsedFiles || parsedFiles.length === 0) {
      throw new BrunoError('No files provided');
    }

    const environments = processFiles(parsedFiles);
    return environments;
  } catch (err) {
    console.error(err);
    throw err instanceof BrunoError ? err : new BrunoError('Import Bruno environment failed');
  }

View on GitHub (pinned to 9bdd81c7bd)

Solutions

  1. Identify the file named in the message and open it.
  2. Resolve the inner environment validation error (see errors 60-66) in that file.
  3. Re-run the import with the corrected file, or import files one at a time to isolate problems.
Defensive patterns

Strategy: try-catch

Validate before calling

for (const f of parsedFiles) {
  if (!isAnyBrunoEnvironmentFormat(f.content)) {
    throw new Error(`${f.fileName} is not a Bruno environment format`);
  }
}

Try / catch

try {
  processFiles(parsedFiles);
} catch (err) {
  const m = err.message.match(/Failed to process (.*?): (.*)/);
  if (m) console.error(`File ${m[1]} failed: ${m[2]}`);
  throw err;
}

Prevention

When it happens

Trigger: A multi-file import where one file produces errors 64, 65, or 66 inside processEnvironmentData; the loop surfaces the failing file name.

Common situations: User selects several .json environment files at once and one of them is corrupted or in the wrong format.

Related errors


AI-assisted analysis of usebruno/bruno@9bdd81c7bd (2026-08-13). Data as JSON: /api/errors/bc0793f89e7d4a07. Report an issue: GitHub.