CKTIS / JavaScript
Blob.stream() и Blob.size: четене и броене на байтове
Използвай `blob.size`, за да получиш общия брой байтове, без да четеш съдържанието, и `blob.stream()`, за да обработваш байтовете на части.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
blob.size // number of bytes; read-only property
blob.stream() // ReadableStream of bytes; no argumentsblob.size е свойство само за четене, което дава общия брой байтове като стойност от тип Number. Използва се без скоби. То не показва броя на знаците или броя на вече прочетените байтове. Конструкторът Blob кодира низовете в UTF-8, затова дължината на низ в JavaScript може да се различава от размера на обекта Blob.
blob.stream() е метод на екземпляра без аргументи. Връща нов ReadableStream със сурови байтове. Използвай size, ако ти трябва само общият размер, и stream(), ако искаш да обработваш данните на части, без да събираш цялото съдържание в един буфер. Не приемай, че частите са с фиксиран размер. За да четеш отново отначало, извикай blob.stream() пак.
getReader() заключва потока за ползване само от този четец. Изчакай резултата от read() с await и провери done, преди да използваш value: done: true означава, че няма следваща част. Тъй като обещанието при четене може да бъде отхвърлено, освободи заключването чрез releaseLock() в finally. Това не връща потока в началото и не го отменя.
Blob и ReadableStream са интерфейси на уеб платформата, а не възможности на езика, гарантирани от ECMAScript 2024. Провери поддръжката им в целевата среда за изпълнение.
Примери
(async () => {
const blob = new Blob(["A\u00E9"]);
const reader = blob.stream().getReader();
let bytesRead = 0;
try {
while (true) {
const { done, value } = await reader.read();
if (done) break;
bytesRead += value.byteLength;
}
} finally {
reader.releaseLock();
}
console.log(`size=${blob.size}; bytesRead=${bytesRead}`);
})().catch((error) => console.error(error));Резултат
size=3; bytesRead=3
В UTF-8 `A` заема един байт, а `é` — два. След прочитане на целия поток сборът от стойностите на `value.byteLength` е 3 и съвпада с `blob.size`, независимо от разделянето на части.
Свързани уроци
- JavaScript · Урок 4 · Напреднало · Версия: 4