CKTIS / JavaScript
Konstruktor `Blob`: vytvoření neměnné posloupnosti bajtů
`new Blob()` spojí textové a binární části do neměnné posloupnosti bajtů. Volby určují typ MIME a způsob zpracování konců řádků v textu.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
new Blob()
new Blob(blobParts)
new Blob(blobParts, options)Blob je globální konstruktor webového rozhraní File API, který poskytuje hostitelské prostředí. Není vestavěnou součástí ECMAScriptu 2024. Je dostupný v prohlížečích a ve Web Workerech; v jiných běhových prostředích si dostupnost ověř. new Blob() synchronně vytvoří prázdný Blob. Volání Blob() bez new vyvolá TypeError. Chceš-li předat volby bez dat, použij new Blob([], options).
blobParts je iterovatelný objekt, například pole řetězců, objektů Blob či ArrayBuffer, typovaných polí nebo pohledů DataView. Konstruktor spojí části v pořadí iterace bez oddělovačů. Neiterovatelný objekt, například {}, vyvolá TypeError. Řetězce se kódují do UTF-8; před kódováním se nespárované zástupné jednotky UTF-16 nahradí znakem U+FFFD. Z pohledu nad ArrayBuffer se zkopírují jen bajty v rozsahu pohledu; předáním view.buffer se místo toho zkopíruje celá vyrovnávací paměť. Pokud typované pole nebo pohled DataView používá jako podklad SharedArrayBuffer, jeho předání vyvolá TypeError. Pozdější změny vstupu bajty objektu Blob nezmění.
Volba type nastavuje metadata typu MIME (blob.type, výchozí hodnota ""). Obsah nepřevádí ani neověřuje; nepoužívej ji jako jedinou kontrolu nedůvěryhodných dat. Výchozí hodnota endings je "transparent" a ponechává konce řádků beze změny. "native" přizpůsobuje konce řádků v řetězcích konvenci hostitelského systému, takže výsledné bajty se mohou lišit podle platformy. Žádná z obou voleb nepřepisuje bajty binárních částí.
blob.size udává počet bajtů, nikoli znaků. blob.arrayBuffer() čte obsah asynchronně jako ArrayBuffer. Konstruktor nevytváří soubor na disku ani adresu URL. Pokud adresu URL vytvoříš zvlášť pomocí URL.createObjectURL(blob), uvolni ji voláním URL.revokeObjectURL(), až ji nebudeš potřebovat.
Příklady
(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(",")}`);
})();Výsledek
size=3, type=text/plain bytes=195,169,33
`é` zabírá v UTF-8 dva bajty a pohled přidá pouze bajt `33`. Změna tohoto bajtu v pohledu na `63` po vytvoření objektu `Blob` neovlivní bajty, které z něj přečteš.
Související lekce
- JavaScript · Lekce 4 · Pokročilá · Verze: 4