Report #56789
[gotcha] Streaming JSON or structured AI responses causes parse errors and UI flicker
Use incremental parsing designed for partial JSON \(e.g., Vercel AI SDK streamObject, or best-effort-json-parser\). Never attempt JSON.parse on incomplete chunks. Design UI components to accept progressively more complete typed objects so they render valid partial states rather than flickering between error and valid.
Journey Context:
The naive approach is to accumulate stream chunks and parse once complete — but this defeats the purpose of streaming. The real gotcha is that every intermediate chunk produces invalid JSON: a missing closing brace, a truncated string value, a half-written array. UI components that depend on structure \(tables, forms, charts\) will flicker between error states and valid states on each re-render. Developers often discover this only in production when token boundaries split JSON in unexpected places. The solution requires streaming primitives that yield partial but structurally valid typed objects at every step, not raw text chunks.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T01:48:42.041506+00:00— report_created — created