CKTIS / JavaScript
Costruttore `Blob`: creare una sequenza immutabile di byte
`new Blob()` unisce testo e dati binari in una sequenza immutabile di byte. Le opzioni impostano il tipo MIME e il trattamento delle terminazioni di riga.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
new Blob()
new Blob(blobParts)
new Blob(blobParts, options)Blob è un costruttore globale della File API del Web fornito dall’ambiente host e non fa parte degli oggetti predefiniti di ECMAScript 2024. È disponibile nei browser e nei Web Worker; verifica la disponibilità negli altri ambienti di esecuzione. new Blob() crea in modo sincrono un Blob vuoto. Chiamare Blob() senza new genera un TypeError. Per passare le opzioni senza dati, usa new Blob([], options).
blobParts è un oggetto iterabile, per esempio un array di stringhe, oggetti Blob o ArrayBuffer, array tipizzati o viste DataView. Il costruttore unisce le parti nell’ordine di iterazione, senza separatori; un oggetto non iterabile come {} genera un TypeError. Le stringhe vengono codificate in UTF-8 dopo aver sostituito i surrogati UTF-16 isolati con U+FFFD. Da una vista su un ArrayBuffer si copiano solo i byte del suo intervallo; passando invece view.buffer si copia l’intero buffer. Passare un array tipizzato o una vista DataView il cui buffer è un SharedArrayBuffer genera un TypeError. Le modifiche successive ai dati in ingresso non alterano i byte del Blob.
L’opzione type imposta il metadato MIME (blob.type, "" per impostazione predefinita). Non converte né convalida il contenuto: non usarla come unico controllo per dati non attendibili. Il valore predefinito di endings, "transparent", conserva le terminazioni di riga. "native" adatta quelle delle stringhe alla convenzione dell’ambiente host, quindi i byte ottenuti possono variare da una piattaforma all’altra. Nessuna delle due opzioni riscrive i byte delle parti binarie.
blob.size conta i byte, non i caratteri. blob.arrayBuffer() legge il contenuto in modo asincrono come ArrayBuffer. Il costruttore non crea un file su disco né un URL. Se crei un URL a parte con URL.createObjectURL(blob), rilascialo con URL.revokeObjectURL() quando non serve più.
Esempi
(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(",")}`);
})();Risultato
size=3, type=text/plain bytes=195,169,33
`é` occupa due byte in UTF-8 e la vista aggiunge solo il byte `33`. Impostare quel byte a `63` nella vista dopo la costruzione non influisce sui byte letti dal `Blob`.
Lezioni correlate
- JavaScript · Lezione 4 · Avanzato · Versione: 4