Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Konstruktor `Blob`: stvaranje nepromjenjivog niza bajtova

`new Blob()` spaja tekst i binarne podatke u nepromjenjivi niz bajtova. Opcije određuju vrstu MIME i način obrade završetaka redaka u tekstu.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

new Blob()
new Blob(blobParts)
new Blob(blobParts, options)

Blob je globalni konstruktor web-sučelja File API koji pruža okruženje domaćina i nije ugrađeni dio ECMAScripta 2024. Dostupan je u preglednicima i u Web Workerima; provjeri njegovu dostupnost u drugim izvršnim okruženjima. new Blob() sinkrono stvara prazan Blob. Poziv Blob() bez new izaziva TypeError. Za prosljeđivanje opcija bez podataka upotrijebi new Blob([], options).

blobParts je iterabilan objekt, primjerice polje znakovnih nizova, objekata Blob ili ArrayBuffer, tipiziranih polja ili pogleda DataView. Konstruktor spaja dijelove redoslijedom iteracije, bez razdjelnika. Neiterabilan objekt poput {} izaziva TypeError. Znakovni nizovi kodiraju se u UTF-8 nakon što se nesparene zamjenske kodne jedinice UTF-16 zamijene znakom U+FFFD. Iz pogleda na ArrayBuffer kopiraju se samo bajtovi u rasponu pogleda; prosljeđivanjem view.buffer umjesto pogleda kopira se cijeli međuspremnik. Prosljeđivanje tipiziranog polja ili pogleda DataView koji koristi SharedArrayBuffer kao međuspremnik izaziva TypeError. Naknadne izmjene ulaznih podataka ne mijenjaju bajtove objekta Blob.

Opcija type postavlja metapodatak o vrsti MIME (blob.type, zadano ""). Ne pretvara niti provjerava sadržaj; nemoj je koristiti kao jedinu provjeru nepouzdanih podataka. Zadana vrijednost endings, "transparent", zadržava završetke redaka. "native" prilagođava završetke redaka u znakovnim nizovima pravilima sustava domaćina, pa se dobiveni bajtovi mogu razlikovati među platformama. Nijedna opcija ne prepisuje bajtove binarnih dijelova.

blob.size broji bajtove, a ne znakove. blob.arrayBuffer() čita sadržaj asinkrono kao ArrayBuffer. Konstruktor ne stvara datoteku na disku niti URL. Ako URL izradiš zasebno pomoću URL.createObjectURL(blob), oslobodi ga pozivom URL.revokeObjectURL() kada više nije potreban.

Primjeri

(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(",")}`);
})();

Rezultat

size=3, type=text/plain
bytes=195,169,33

`é` zauzima dva bajta u UTF-8, a pogled dodaje samo bajt `33`. Promjena tog bajta u pogledu na `63` nakon stvaranja objekta `Blob` ne utječe na bajtove koji se iz njega čitaju.

Povezane lekcije

  • JavaScript · Lekcija 4 · Napredno · Verzija: 4

Izvori