Y2Z/monolith · error

Unable to serialize DOM into buffer

Error message

Unable to serialize DOM into buffer

What it means

`serialize_document` performs the final full-document serialization and panics with `.expect("Unable to serialize DOM into buffer")` if html5ever's `serialize` returns `Err`. At this stage the DOM has been heavily rewritten (assets embedded, noscript handling); any node the serializer cannot write aborts the run. It is the last-mile variant of the same DOM-serialization panic family.

Source

Thrown at src/html.rs:648

                        Attribute {
                            name: QualName::new(None, ns!(), LocalName::from("content")),
                            value: format_tendril!("{}", compose_csp(options)),
                        },
                    ],
                );
                // The CSP meta-tag has to be prepended, never appended,
                //  since there already may be one defined in the original document,
                //   and browsers don't allow re-defining them (for obvious reasons)
                head.children.borrow_mut().reverse();
                head.children.borrow_mut().push(meta.clone());
                head.children.borrow_mut().reverse();
            }
        }
    }

    let serializable: SerializableHandle = dom.document.into();
    serialize(&mut buf, &serializable, SerializeOpts::default())
        .expect("Unable to serialize DOM into buffer");

    // Unwrap NOSCRIPT elements
    if options.unwrap_noscript {
        let s: &str = &String::from_utf8_lossy(&buf);
        let noscript_re = Regex::new(r"<(?P<c>/?noscript[^>]*)>").unwrap();
        buf = noscript_re.replace_all(s, "<!--$c-->").as_bytes().to_vec();
    }

    if !document_encoding.is_empty() {
        if let Some(encoding) = Encoding::for_label(document_encoding.as_bytes()) {
            let s: &str = &String::from_utf8_lossy(&buf);
            let (data, _, _) = encoding.encode(s);
            buf = data.to_vec();
        }
    }

    buf
}

View on GitHub (pinned to a6fc8d0095)

Solutions

1. Inspect what was embedded: ensure data: URLs / inlined assets are percent-encoded and contain no raw invalid characters.
2. Bisect by disabling embed options to find which document mutation breaks serialization.
3. Propagate a `Result` or log-and-skip instead of expect-panicking so one bad document doesn't abort a batch.
4. Pin/upgrade monolith and html5ever versions together; report the failing document upstream with a minimal repro.

Example fix

// before
serialize(&mut buf, &serializable, SerializeOpts::default())
    .expect("Unable to serialize DOM into buffer");
// after
if serialize(&mut buf, &serializable, SerializeOpts::default()).is_err() {
    eprintln!("final serialization failed; using raw source HTML");
    buf = raw_source_html.to_vec();
}

fn embedded_payload_is_clean(doc: &str) -> bool {
    // reject NULs / control chars injected by binary embeds
    doc.chars().all(|c| c != '\u{0}' && !c.is_control() || c.is_whitespace())
}

let result = std::panic::catch_unwind(|| serialize_document(dom, &options));
match result {
    Ok(buf) => write_output(buf),
    Err(_) => {
        eprintln!("final serialization failed; falling back to raw source HTML");
        write_output(raw_source_html);
    }
}

When it happens

Trigger: `create_monolithic_document_from_data` -> `serialize_document` panics when the final `serialize` of `dom.document` fails — usually due to invalid node state introduced by earlier embedding/rewriting steps (e.g. malformed elements or unencodable text from asset embedding).

Common situations: Embedding binary assets into data: URLs or inline content that inserted unencodable text into the DOM; extremely broken source HTML; monolith/html5ever version upgrades changing serialization strictness.

Related errors

• unable to serialize DOM into buffer
• Time went backwards
• Failed to initialize HTTP client
• unable to read file
• could not prepare output

AI-assisted analysis of Y2Z/monolith@a6fc8d0095 (2026-09-05). Data as JSON: /api/errors/cc3496a03defdfc8. Report an issue: GitHub.