Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Konstruktor `Blob`: ustvarjanje nespremenljivega zaporedja bajtov

`new Blob()` združi besedilo in binarne podatke v nespremenljivo zaporedje bajtov. Možnosti določajo tip MIME in obravnavo koncev vrstic v besedilu.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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

Blob je globalni konstruktor spletnega vmesnika File API, ki ga zagotavlja gostiteljsko okolje, in ni vgrajen del ECMAScripta 2024. Na voljo je v brskalnikih in v okolju Web Workers; v drugih izvajalnih okoljih preveri njegovo razpoložljivost. new Blob() sinhrono ustvari prazen Blob. Klic Blob() brez new sproži TypeError. Za podajanje možnosti brez podatkov uporabi new Blob([], options).

blobParts je objekt, po katerem je mogoče iterirati, na primer polje nizov, objektov Blob ali ArrayBuffer, tipiziranih polj ali pogledov DataView. Konstruktor združi dele v vrstnem redu iteracije, brez ločil. Objekt, po katerem ni mogoče iterirati, na primer {}, povzroči TypeError. Nizi se kodirajo v UTF-8, pri čemer se neparne nadomestne kodne enote UTF-16 pred kodiranjem nadomestijo z znakom U+FFFD. Iz pogleda na ArrayBuffer se kopirajo samo bajti v obsegu pogleda; če namesto pogleda podaš view.buffer, se kopira celoten medpomnilnik. Če podaš tipizirano polje ali pogled DataView, ki uporablja SharedArrayBuffer kot medpomnilnik, konstruktor sproži TypeError. Poznejše spremembe vhodnih podatkov ne spremenijo bajtov objekta Blob.

Možnost type nastavi metapodatek o tipu MIME (blob.type, privzeto ""). Vsebine ne pretvori in je ne preveri; ne uporabljaj je kot edinega preverjanja podatkov iz nezaupanja vrednih virov. Privzeta vrednost endings, "transparent", ohrani konce vrstic. "native" prilagodi konce vrstic v nizih konvenciji gostiteljskega sistema, zato se lahko dobljeni bajti med platformami razlikujejo. Nobena možnost ne prepiše bajtov binarnih delov.

blob.size šteje bajte, ne znakov. blob.arrayBuffer() vsebino asinhrono prebere kot ArrayBuffer. Konstruktor ne ustvari datoteke na disku niti naslova URL. Če naslov URL ustvariš posebej z URL.createObjectURL(blob), ga sprosti z URL.revokeObjectURL(), ko ga ne potrebuješ več.

Primeri

(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

`é` v UTF-8 zavzame dva bajta, pogled pa doda samo bajt `33`. Če po ustvarjanju objekta `Blob` spremeniš ta bajt v pogledu na `63`, to ne vpliva na bajte, prebrane iz objekta `Blob`.

Povezane lekcije

  • JavaScript · Lekcija 4 · Napredna · Različica: 4

Viri