CKTIS / JavaScript
Constructeur `Blob` : créer une séquence d’octets immuable
`new Blob()` assemble du texte et des données binaires en une séquence d’octets immuable. Ses options règlent le type MIME et le traitement des fins de ligne.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
new Blob()
new Blob(blobParts)
new Blob(blobParts, options)Blob est un constructeur global de la File API du Web fourni par l’environnement hôte, et non un objet natif d’ECMAScript 2024. Il est disponible dans les navigateurs et les Web Workers ; vérifiez sa disponibilité dans les autres environnements d’exécution. new Blob() crée un Blob vide de façon synchrone. Appeler Blob() sans new déclenche une TypeError. Pour passer des options sans données, utilisez new Blob([], options).
blobParts est un objet itérable, par exemple un tableau de chaînes, d’objets Blob ou ArrayBuffer, de tableaux typés ou d’objets DataView. Le constructeur assemble les parties dans l’ordre d’itération, sans séparateur ; un objet non itérable comme {} déclenche une TypeError. Les chaînes sont encodées en UTF-8 après remplacement des demi-codets UTF-16 isolés par U+FFFD. Pour une vue sur un ArrayBuffer, seuls les octets couverts par la vue sont copiés ; passer view.buffer à la place copie tout le tampon. Passer un tableau typé ou un objet DataView dont le tampon est un SharedArrayBuffer déclenche une TypeError. Les modifications ultérieures de l’entrée ne changent pas les octets du Blob.
L’option type définit la métadonnée MIME (blob.type, "" par défaut). Elle ne convertit ni ne valide le contenu ; ne vous y fiez pas seule pour valider des données non fiables. Par défaut, endings vaut "transparent" et conserve les fins de ligne. "native" adapte les fins de ligne des chaînes à la convention du système hôte : les octets obtenus peuvent donc varier selon la plateforme. Aucune de ces deux options ne réécrit les octets des parties binaires.
blob.size compte les octets, pas les caractères. blob.arrayBuffer() lit le contenu de façon asynchrone sous forme d’ArrayBuffer. Le constructeur ne crée ni fichier sur disque ni URL. Si vous créez séparément une URL avec URL.createObjectURL(blob), libérez-la avec URL.revokeObjectURL() lorsqu’elle n’est plus nécessaire.
Exemples
(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(",")}`);
})();Résultat
size=3, type=text/plain bytes=195,169,33
`é` occupe deux octets en UTF-8 et la vue n’ajoute que l’octet `33`. Passer cet octet à `63` dans la vue après la construction ne change pas les octets lus dans le `Blob`.
Leçons associées
- JavaScript · Leçon 4 · Avancé · Version : 4