Skip to content

HttpClientStreamResponse ​

HttpClientStreamResponse é o valor de sucesso em await fetch.stream(url, options?). A promise retorna Err(HttpError) se a requisição falhar antes da chegada do status e dos headers; depois disso, falhas do stream são informadas por StreamError.

AssinaturaHttpClientStreamResponse

Métodos ​

MétodoAssinaturaFinalidade
status() => i32Devolve o código de status HTTP.
ok() => booleanDevolve se o status está na faixa 2xx.
header(name: string) => string?Devolve um header da resposta sem considerar maiúsculas e minúsculas.
stream() => Promise<ReadableStream<u8[]>>Devolve o corpo legível progressivamente.
close() => voidAborta um corpo não lido e libera a resposta.

Uso ​

tyrus
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);
    }
}

Use fetch(...) comum quando o corpo inteiro for necessário como text(), bytes() ou json<T>(). fetch.stream(...) mantém no máximo um buffer limitado de transferência em memória e aplica backpressure enquanto ReadableStream.read() está esperando. Depois que stream() devolve seu leitor, close() libera o cabeçalho da resposta sem interromper esse leitor; feche o leitor para abandonar a transferência. Fechar uma resposta antes de obter um leitor cancela sua transferência. Uma falha de transporte antes de os headers chegarem retorna Err(HttpError) em fetch.stream(...); uma falha depois desse ponto faz o stream legível falhar com StreamError.