Deno.Reader

Абстрактный интерфейс, который при реализации предоставляет интерфейс для асинхронного чтения байтов в буфер массива.

interface Reader {read(p: Uint8Array): Promise<number | null>;
}

Методы

read(p: Uint8Array): Promise<number | null>

Считывает до p.byteLength байтов в p. Возвращает количество прочитанных байтов (0 < n <= p.byteLength) и отклоняет, если возникает какая-либо ошибка. Даже если read() возвращает n < p.byteLength, оно может использовать все p в качестве рабочей области во время вызова. Если доступны данные, но не p.byteLength байтов, read() обычно возвращает доступные данные вместо ожидания дополнительных данных.

Когда read() встречает конец файла, оно возвращает EOF (null).

Когда read() встречает ошибку, оно отклоняет её с ошибкой.

Вызывающие стороны должны всегда обработать полученные n > 0 байты перед рассмотрением EOF (null). Это правильно обрабатывает ошибки ввода-вывода, которые происходят после считывания некоторых байтов, а также оба разрешённых поведения EOF.

Реализации не должны сохранять ссылку на p.

Используйте itereateReader из std/streams/conversion.ts, чтобы преобразовать Reader в {@link AsyncIterator}.