{"record":{"id":"610d7adffc00a047","repo":"withastro/astro","slug":"svg-file-does-not-contain-an-svg-element","errorCode":null,"errorMessage":"SVG file does not contain an element","messagePattern":"SVG file does not contain an element","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/astro/src/assets/svg/utils.ts","lineNumber":36,"sourceCode":"\tif (svgOptimizer) {\n\t\ttry {\n\t\t\tprocessedContents = await svgOptimizer.optimize(contents);\n\t\t} catch (cause) {\n\t\t\tthrow new AstroError(\n\t\t\t\t{\n\t\t\t\t\t...AstroErrorData.CannotOptimizeSvg,\n\t\t\t\t\tmessage: AstroErrorData.CannotOptimizeSvg.message(path, svgOptimizer.name),\n\t\t\t\t},\n\t\t\t\t{ cause },\n\t\t\t);\n\t\t}\n\t}\n\tconst root = parse(processedContents);\n\tconst svgNode = root.children.find(\n\t\t({ name, type }: { name: string; type: number }) => type === ELEMENT_NODE && name === 'svg',\n\t);\n\tif (!svgNode) {\n\t\tthrow new Error('SVG file does not contain an element');\n\t}\n\tconst { attributes, children } = svgNode;\n\tconst body = renderSync({ ...root, children });\n\n\t// Collect text content of …\nimport logo from './logo.svg';\n\n// after — logo.svg is a single root element\n// …\nimport logo from './logo.svg';","handlingStrategy":"validation","validationCode":"import { readFileSync } from 'node:fs';\nfunction hasSvgRoot(path: string): boolean {\n const txt = readFileSync(path, 'utf8').trim();\n return /^\\s*$/i.test(txt);\n}","typeGuard":"function isSvgFile(content: string): boolean {\n return /][\\s\\S]*<\\/svg>/i.test(content);\n}","tryCatchPattern":null,"preventionTips":["Export SVGs from a design tool rather than hand-writing HTML-wrapped files.","Add a pre-commit lint with svgo --pretty to enforce a single root.","Do not rename non-SVG files to .svg."],"tags":["svg","assets","file-format","validation"],"backgroundTag":null,"analyzedSha":"d081033d5fe8e8a68c4bbbad4af9d2deb9c74bca","analyzedAt":"2026-08-12T13:37:29.035Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}