📄 ai-sdk/docs/reference/ai-sdk-ui/read-ui-message-stream
File: read-ui-message-stream.md | Updated: 11/15/2025
Source: https://ai-sdk.dev/docs/reference/ai-sdk-ui/read-ui-message-stream
Menu
v5 (Latest)
AI SDK 5.x
Model Context Protocol (MCP) Tools
Copy markdown
==============================================================================================================
Transforms a stream of UIMessageChunks into an AsyncIterableStream of UIMessages.
UI message streams are useful outside of Chat use cases, e.g. for terminal UIs, custom stream consumption on the client, or RSC (React Server Components).
import { readUIMessageStream } from 'ai';
Parameters
message?:
UIMessage
The last assistant message to use as a starting point when the conversation is resumed. Otherwise undefined.
stream:
ReadableStream<UIMessageChunk>
The stream of UIMessageChunk objects to read.
onError?:
(error: unknown) => void
A function that is called when an error occurs during stream processing.
terminateOnError?:
boolean
Whether to terminate the stream if an error occurs. Defaults to false.
Returns
An AsyncIterableStream of UIMessages. Each stream part represents a different state of the same message as it is being completed.
For comprehensive examples and use cases, see Reading UI Message Streams .
On this page
Deploy and Scale AI Apps with Vercel.
Vercel delivers the infrastructure and developer experience you need to ship reliable AI-powered applications at scale.
Trusted by industry leaders:
- OpenAI
- Photoroom
