База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Конструктор `Blob`: създаване на неизменяема поредица от байтове

`new Blob()` обединява текст и двоични данни в неизменяема поредица от байтове. Опциите задават MIME типа и начина на обработка на краищата на редовете.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

Blob е глобален конструктор от уеб интерфейса File API, предоставян от средата на изпълнение, а не вграден елемент на ECMAScript 2024. Достъпен е в браузъри и в Web Workers; провери наличността му в други среди. new Blob() създава синхронно празен Blob. Извикването на Blob() без new предизвиква TypeError. За да подадеш само опции, използвай new Blob([], options).

blobParts е итерируем обект, например масив от низове, обекти Blob или ArrayBuffer, типизирани масиви или изгледи DataView. Конструкторът съединява частите в реда на обхождане, без разделители. Неитерируем обект като {} предизвиква TypeError. Низовете се кодират в UTF-8, след като несдвоените сурогатни кодови единици в UTF-16 се заменят с U+FFFD. От изглед върху ArrayBuffer се копират само байтовете в обхвата на изгледа; ако подадеш view.buffer вместо изгледа, се копира целият буфер. Подаването на типизиран масив или изглед DataView с буфер SharedArrayBuffer предизвиква TypeError. По-късните промени във входните данни не променят байтовете на Blob.

Опцията type задава метаданните за MIME типа (blob.type, по подразбиране ""). Тя не преобразува и не проверява съдържанието; не я използвай като единствена проверка на ненадеждни данни. Стойността по подразбиране на endings е "transparent" и запазва краищата на редовете. "native" приспособява краищата на редовете в низовете към конвенцията на системата, затова получените байтове може да се различават между платформите. Нито една от опциите не презаписва байтовете на двоичните части.

blob.size брои байтове, а не знаци. blob.arrayBuffer() прочита съдържанието асинхронно като ArrayBuffer. Конструкторът не създава файл на диска или URL адрес. Ако създадеш отделно URL адрес чрез URL.createObjectURL(blob), освободи го с URL.revokeObjectURL(), когато вече не е необходим.

Примери

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

Резултат

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

`é` заема два байта в UTF-8, а изгледът добавя само байта `33`. Промяната на този байт на `63` в изгледа след създаването на `Blob` не засяга байтовете, прочетени от него.

Свързани уроци

  • JavaScript · Урок 4 · Напреднало · Версия: 4

Източници