CKTIS / JavaScript
Konstruktor `Blob`: tworzenie niemodyfikowalnych danych binarnych
Użyj `new Blob()`, aby połączyć tekst i dane binarne w niemodyfikowalny ciąg bajtów. Opcje określają typ MIME i sposób traktowania końców wierszy.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
new Blob()
new Blob(blobParts)
new Blob(blobParts, options)Blob jest globalnym konstruktorem udostępnianym przez środowisko, należy do webowego File API i nie jest wbudowanym elementem ECMAScript 2024. Jest dostępny w przeglądarkach i w Web Workers; w innych środowiskach sprawdź jego dostępność. new Blob() synchronicznie tworzy pusty obiekt Blob. Wywołanie Blob() bez new zgłasza TypeError. Aby przekazać same opcje, użyj new Blob([], options).
blobParts to obiekt iterowalny, na przykład tablica zawierająca łańcuchy znaków, obiekty Blob, bufory ArrayBuffer, tablice typowane lub widoki DataView. Konstruktor łączy części w kolejności iteracji, bez separatorów; nieiterowalny obiekt, taki jak {}, powoduje TypeError. Łańcuchy są kodowane w UTF-8, a niesparowane jednostki zastępcze UTF-16 są przed kodowaniem zastępowane znakiem U+FFFD. Gdy widok korzysta z bufora ArrayBuffer, kopiowane są tylko bajty w zakresie widoku; przekazanie view.buffer zamiast widoku powoduje skopiowanie całego bufora. Przekazanie tablicy typowanej lub widoku DataView opartego na SharedArrayBuffer powoduje zgłoszenie TypeError. Późniejsze modyfikacje danych wejściowych nie zmieniają bajtów obiektu Blob.
Opcja type ustawia metadane typu MIME (blob.type, domyślnie ""). Nie konwertuje ani nie sprawdza zawartości; nie używaj jej jako jedynej metody weryfikacji niezaufanych danych. Opcja endings ma domyślnie wartość "transparent", która zachowuje końce wierszy. "native" dostosowuje je w częściach tekstowych do konwencji systemu, więc wynikowe bajty mogą różnić się między platformami. Żadna z opcji nie przepisuje bajtów części binarnych.
blob.size podaje liczbę bajtów, a nie znaków. blob.arrayBuffer() odczytuje zawartość asynchronicznie jako ArrayBuffer. Konstruktor nie tworzy pliku na dysku ani adresu URL. Jeśli osobno utworzysz adres przez URL.createObjectURL(blob), zwolnij go przez URL.revokeObjectURL(), gdy nie będzie już potrzebny.
Przykłady
(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(",")}`);
})();Wynik
size=3, type=text/plain bytes=195,169,33
`é` zajmuje dwa bajty w UTF-8, a widok dodaje tylko bajt `33`. Zmiana tego bajtu w widoku na `63` po utworzeniu obiektu `Blob` nie wpływa na odczyt.
Powiązane lekcje
- JavaScript · Lekcja 4 · Zaawansowany · Wersja: 4