CKTIS / JavaScript
`Blob`-Konstruktor: unveränderliche Bytedaten erzeugen
Mit `new Blob()` verbindest du Text und Binärdaten zu einer unveränderlichen Bytefolge. Optionen legen den MIME-Typ und die Behandlung von Zeilenenden fest.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
new Blob()
new Blob(blobParts)
new Blob(blobParts, options)Blob ist ein globaler Konstruktor der Web-File-API, den die Laufzeitumgebung bereitstellt. Er gehört nicht zu den eingebauten Objekten von ECMAScript 2024. Er ist in Browsern und Web Workern verfügbar; prüfe die Verfügbarkeit in anderen Laufzeitumgebungen. new Blob() erzeugt synchron einen leeren Blob. Ein Aufruf von Blob() ohne new löst einen TypeError aus. Wenn du nur Optionen übergeben willst, verwende new Blob([], options).
blobParts ist ein iterierbares Objekt, etwa ein Array mit Zeichenketten, Blob-Objekten, ArrayBuffer-Objekten, typisierten Arrays oder DataView-Objekten. Der Konstruktor fügt die Teile ohne Trennzeichen in Iterationsreihenfolge zusammen. Ein nicht iterierbares Objekt wie {} löst einen TypeError aus. Zeichenketten werden als UTF-8 kodiert; einzelne UTF-16-Surrogate ohne Gegenstück werden vorher durch U+FFFD ersetzt. Bei einer Sicht auf einen ArrayBuffer werden nur die Bytes im Bereich der Sicht kopiert; mit view.buffer wird stattdessen der gesamte Puffer kopiert. Liegt einem typisierten Array oder DataView-Objekt ein SharedArrayBuffer zugrunde, löst die Übergabe einen TypeError aus. Spätere Änderungen an der Eingabe ändern die Bytes des Blob nicht.
Die Option type setzt die MIME-Metadaten (blob.type, standardmäßig ""). Sie konvertiert und prüft den Inhalt nicht. Verwende sie nicht als einzige Prüfung für nicht vertrauenswürdige Daten. Die Voreinstellung "transparent" für endings lässt Zeilenenden unverändert. "native" passt sie in Zeichenketten an die Konvention des Systems an; dadurch können sich die resultierenden Bytes je nach Plattform unterscheiden. Keine der beiden Optionen verändert die Bytes binärer Teile.
blob.size zählt Bytes, nicht Zeichen. blob.arrayBuffer() liest den Inhalt asynchron als ArrayBuffer. Der Konstruktor legt weder eine Datei auf dem Datenträger noch eine URL an. Wenn du separat mit URL.createObjectURL(blob) eine URL erzeugst, gib sie mit URL.revokeObjectURL() frei, sobald sie nicht mehr benötigt wird.
Beispiele
(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(",")}`);
})();Ergebnis
size=3, type=text/plain bytes=195,169,33
`é` belegt in UTF-8 zwei Bytes, und die Sicht steuert nur das Byte `33` bei. Wird dieses Byte nach der Konstruktion in der Sicht auf `63` gesetzt, bleiben die aus dem `Blob` gelesenen Bytes unverändert.
Zugehörige Lektionen
- JavaScript · Lektion 4 · Fortgeschritten · Version: 4