HttpClientStreamResponse
HttpClientStreamResponse es el valor de éxito de await fetch.stream(url, options?). La promise devuelve Err(HttpError) si la petición falla antes de que lleguen el estado y las cabeceras; después, los fallos del stream se notifican mediante StreamError.
HttpClientStreamResponseMétodos
| Método | Firma | Propósito |
|---|---|---|
status | () => i32 | Devuelve el código de estado HTTP. |
ok | () => boolean | Devuelve si el estado está en el rango 2xx. |
header | (name: string) => string? | Devuelve una cabecera de respuesta sin considerar mayúsculas y minúsculas. |
stream | () => Promise<ReadableStream<u8[]>> | Devuelve el cuerpo legible progresivamente. |
close | () => void | Cancela un cuerpo no leído y libera la respuesta. |
Uso
import { fetch, HttpClientStreamResponse, HttpError } from "tyrus:http";
import { ReadableStream, StreamError } from "tyrus:stream";
async function openDownload(url: string): Promise<ReadableStream<u8[]>> {
try {
const result = await fetch.stream(url);
const response: HttpClientStreamResponse = match result {
Ok(value) => value,
Err(error) => { console.error(error.code); throw error; }
};
const body: ReadableStream<u8[]> = await response.stream();
response.close();
return body;
} catch (error: HttpError) {
console.error(error.code);
throw error;
}
}
async function download(url: string): Promise<void> {
const body: ReadableStream<u8[]> = await openDownload(url);
try {
const first: u8[]? = await body.read();
} catch (error: StreamError) {
console.error(error.code);
}
}Usa fetch(...) normal cuando se necesite el cuerpo completo como text(), bytes() o json<T>(). fetch.stream(...) conserva como máximo un búfer de transferencia limitado en memoria y aplica backpressure mientras ReadableStream.read() está esperando. Después de que stream() devuelve su lector, close() libera la cabecera de la respuesta sin interrumpir ese lector; cierra el lector para abandonar la transferencia. Cerrar una respuesta antes de obtener un lector cancela su transferencia. Un fallo de transporte antes de que lleguen las cabeceras devuelve Err(HttpError) en fetch.stream(...); un fallo después de ese punto hace que el stream legible falle con StreamError.
