CKTIS / JavaScript
Konštruktor `Blob`: vytvorenie nemennej postupnosti bajtov
`new Blob()` spojí textové a binárne časti do nemennej postupnosti bajtov. Voľby určujú typ MIME a spôsob spracovania koncov riadkov v texte.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
new Blob()
new Blob(blobParts)
new Blob(blobParts, options)Blob je globálny konštruktor webového rozhrania File API, ktorý poskytuje hostiteľské prostredie. Nie je vstavanou súčasťou ECMAScriptu 2024. Je dostupný v prehliadačoch a vo Web Workeroch; v iných prostrediach si dostupnosť over. new Blob() synchrónne vytvorí prázdny Blob. Volanie Blob() bez new vyvolá TypeError. Ak chceš odovzdať voľby bez údajov, použi new Blob([], options).
blobParts je iterovateľný objekt, napríklad pole reťazcov, objektov Blob alebo ArrayBuffer, typovaných polí či pohľadov DataView. Konštruktor spojí časti v poradí iterácie bez oddeľovačov. Neiterovateľný objekt, napríklad {}, vyvolá TypeError. Reťazce sa kódujú do UTF-8; pred kódovaním sa nespárované náhradné jednotky UTF-16 nahradia znakom U+FFFD. Z pohľadu nad ArrayBuffer sa skopírujú len bajty v rozsahu pohľadu; odovzdaním view.buffer sa namiesto toho skopíruje celá vyrovnávacia pamäť. Ak typované pole alebo pohľad DataView používa ako podklad SharedArrayBuffer, jeho odovzdanie vyvolá TypeError. Neskoršie zmeny vstupu nezmenia bajty objektu Blob.
Voľba type nastavuje metadáta typu MIME (blob.type, predvolená hodnota ""). Obsah nekonvertuje ani neoveruje; nepoužívaj ju ako jedinú kontrolu nedôveryhodných údajov. Predvolená hodnota endings je "transparent" a zachováva konce riadkov. Hodnota "native" prispôsobí konce riadkov v reťazcoch konvencii hostiteľského systému, takže výsledné bajty sa môžu líšiť podľa platformy. Žiadna z oboch volieb neprepisuje bajty binárnych častí.
blob.size udáva počet bajtov, nie znakov. blob.arrayBuffer() číta obsah asynchrónne ako ArrayBuffer. Konštruktor nevytvára súbor na disku ani adresu URL. Ak adresu URL vytvoríš samostatne pomocou URL.createObjectURL(blob), uvoľni ju volaním URL.revokeObjectURL(), keď ju už nebudeš potrebovať.
Prí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ýsledok
size=3, type=text/plain bytes=195,169,33
`é` zaberá v UTF-8 dva bajty a pohľad pridá iba bajt `33`. Zmena tohto bajtu v pohľade na `63` po vytvorení objektu `Blob` neovplyvní bajty, ktoré z neho prečítaš.
Súvisiace lekcie
- JavaScript · Lekcia 4 · Pokročilá · Verzia: 4