CKTIS / JavaScript
Constructor `Blob`: crear una secuencia inmutable de bytes
`new Blob()` combina texto y datos binarios en una secuencia inmutable de bytes. Sus opciones fijan el tipo MIME y el tratamiento de los finales de línea.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
new Blob()
new Blob(blobParts)
new Blob(blobParts, options)Blob es un constructor global de la File API web que proporciona el entorno anfitrión, no un objeto incorporado de ECMAScript 2024. Está disponible en navegadores y Web Workers; comprueba su disponibilidad en otros entornos de ejecución. new Blob() crea un Blob vacío de forma síncrona. Llamar a Blob() sin new lanza un TypeError. Para pasar opciones sin datos, usa new Blob([], options).
blobParts es un objeto iterable, como un array de cadenas, objetos Blob o ArrayBuffer, arrays tipados o vistas DataView. El constructor une las partes en orden de iteración, sin separadores; un objeto no iterable como {} provoca un TypeError. Las cadenas se codifican en UTF-8 tras sustituir los sustitutos UTF-16 no emparejados por U+FFFD. De una vista sobre un ArrayBuffer se copian solo los bytes de su intervalo; pasar view.buffer en su lugar copia todo el búfer. Pasar un array tipado o una vista DataView cuyo búfer sea un SharedArrayBuffer provoca un TypeError. Los cambios posteriores en la entrada no modifican los bytes del Blob.
La opción type establece el metadato MIME (blob.type, "" por defecto). No convierte ni valida el contenido; no la uses como única comprobación de datos no fiables. endings vale "transparent" de forma predeterminada y conserva los finales de línea. "native" adapta los finales de línea de las cadenas a la convención del sistema anfitrión, por lo que los bytes resultantes pueden variar según la plataforma. Ninguna de las opciones reescribe los bytes de las partes binarias.
blob.size cuenta bytes, no caracteres. blob.arrayBuffer() lee el contenido de forma asíncrona como un ArrayBuffer. El constructor no crea un archivo en disco ni una URL. Si creas una URL por separado con URL.createObjectURL(blob), libérala mediante URL.revokeObjectURL() cuando ya no haga falta.
Ejemplos
(async () => {
const bufferView = new Uint8Array([0, 33, 0]);
const part = bufferView.subarray(1, 2);
const blob = new Blob(["\u00E9", part], { type: "text/plain" });
part[0] = 63;
const bytes = new Uint8Array(await blob.arrayBuffer());
console.log(`size=${blob.size}, type=${blob.type}`);
console.log(`bytes=${bytes.join(",")}`);
})();Resultado
size=3, type=text/plain bytes=195,169,33
`é` ocupa dos bytes en UTF-8, y la vista solo aporta el byte `33`. Cambiar ese byte a `63` en la vista después de la construcción no afecta a los bytes que se leen del `Blob`.
Lecciones relacionadas
- JavaScript · Lección 4 · Avanzado · Versión: 4