KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

`Blob`-constructor: een onveranderlijke bytereeks maken

Met `new Blob()` voeg je tekst en binaire gegevens samen tot een onveranderlijke bytereeks. Opties bepalen het MIME-type en de verwerking van regeleinden.

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

Syntax

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

Blob is een globale constructor uit de File API van het web die de uitvoeringsomgeving beschikbaar stelt. Het is geen ingebouwd onderdeel van ECMAScript 2024. De constructor is beschikbaar in browsers en Web Workers; controleer de beschikbaarheid in andere omgevingen. new Blob() maakt synchroon een lege Blob. Een aanroep van Blob() zonder new geeft een TypeError. Gebruik new Blob([], options) om opties zonder gegevens mee te geven.

blobParts is een itereerbaar object, bijvoorbeeld een array met tekenreeksen, Blob- of ArrayBuffer-objecten, getypeerde arrays of DataView-objecten. De constructor voegt de delen in iteratievolgorde samen, zonder scheidingstekens. Een niet-itereerbaar object zoals {} geeft een TypeError. Tekenreeksen worden gecodeerd als UTF-8 nadat losse UTF-16-surrogaten door U+FFFD zijn vervangen. Van een view op een ArrayBuffer worden alleen de bytes in het bereik van die view gekopieerd; met view.buffer kopieer je in plaats daarvan de hele buffer. Als je een getypeerde array of een DataView met een SharedArrayBuffer als onderliggende buffer doorgeeft, krijg je een TypeError. Latere wijzigingen aan de invoer veranderen de bytes van de Blob niet.

De optie type stelt MIME-metadata in (blob.type, standaard ""). Ze converteert of valideert de inhoud niet; gebruik haar niet als enige controle voor onvertrouwde gegevens. De standaardwaarde "transparent" voor endings behoudt regeleinden. Met "native" worden regeleinden in tekenreeksen aangepast aan de conventie van het hostsysteem, waardoor de resulterende bytes per platform kunnen verschillen. Geen van beide opties herschrijft de bytes van binaire delen.

blob.size telt bytes, geen tekens. blob.arrayBuffer() leest de inhoud asynchroon als een ArrayBuffer. De constructor maakt geen bestand op schijf en geen URL. Maak je apart een URL met URL.createObjectURL(blob), geef die dan vrij met URL.revokeObjectURL() zodra hij niet meer nodig is.

Voorbeelden

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

Resultaat

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

`é` neemt twee bytes in UTF-8 in en de view voegt alleen byte `33` toe. Als je die byte na constructie in de view wijzigt naar `63`, heeft dat geen invloed op de bytes die je uit de `Blob` leest.

Gerelateerde lessen

  • JavaScript · Les 4 · Gevorderd · Versie: 4

Bronnen