Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Blob.stream() y Blob.size: leer bytes o contarlos

Usa `blob.size` para saber cuántos bytes hay en total sin leer el contenido, y `blob.stream()` para procesar esos bytes por bloques.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

blob.size      // number of bytes; read-only property
blob.stream()  // ReadableStream of bytes; no arguments

blob.size es una propiedad de solo lectura que devuelve el número total de bytes como Number. Se consulta sin paréntesis. No cuenta caracteres ni bytes leídos hasta el momento. El constructor Blob codifica las cadenas en UTF-8, por lo que la longitud de una cadena de JavaScript puede ser distinta del tamaño del blob.

blob.stream() es un método de instancia sin argumentos. Devuelve un nuevo ReadableStream de bytes sin decodificar. Usa size si solo necesitas el total, y stream() si quieres procesar los datos por bloques sin acumular todo el contenido en un único búfer. No supongas que los bloques tienen un tamaño fijo. Para volver a leer desde el principio, llama otra vez a blob.stream().

getReader() bloquea el flujo para uso exclusivo de ese lector. Espera el resultado de read() con await y comprueba done antes de usar value: done: true indica que no hay otro bloque. Como la promesa de lectura puede rechazarse, libera el bloqueo con releaseLock() en finally. Esto no rebobina ni cancela el flujo.

Blob y ReadableStream son API de la plataforma web, no funciones del lenguaje garantizadas por ECMAScript 2024. Comprueba que estén disponibles en tu entorno de ejecución de destino.

Ejemplos

(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));

Resultado

size=3; bytesRead=3

En UTF-8, `A` ocupa un byte y `é` ocupa dos. Al completar la lectura, la suma de `value.byteLength` es 3 y coincide con `blob.size`, sin importar cómo se dividan los bloques.

Lecciones relacionadas

  • JavaScript · Lección 4 · Avanzado · Versión: 4

Fuentes