CKTIS / JavaScript
Blob.stream() et Blob.size : lire ou compter les octets
Utilisez `blob.size` pour connaître le nombre total d’octets sans lire le contenu, et `blob.stream()` pour traiter ces octets par blocs.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
blob.size // number of bytes; read-only property
blob.stream() // ReadableStream of bytes; no argumentsblob.size est une propriété en lecture seule qui donne le nombre total d’octets sous forme de Number. Elle s’utilise sans parenthèses. Elle ne compte ni les caractères ni les octets déjà lus. Le constructeur Blob encode les chaînes en UTF-8 : la longueur d’une chaîne JavaScript peut donc différer de la taille du blob.
blob.stream() est une méthode d’instance sans argument. Elle renvoie un nouveau ReadableStream d’octets bruts. Utilisez size si seul le total vous intéresse, et stream() pour traiter les données par blocs sans rassembler tout le contenu dans un seul tampon. Ne supposez pas que les blocs ont une taille fixe. Pour relire depuis le début, appelez de nouveau blob.stream().
getReader() réserve le flux à ce lecteur. Attendez le résultat de read() avec await et vérifiez done avant d’utiliser value : done: true indique qu’il n’y a plus de bloc. Comme la promesse peut être rejetée, libérez le verrou avec releaseLock() dans finally. Cela ne rembobine ni n’annule le flux.
Blob et ReadableStream sont des API de la plateforme web, pas des fonctionnalités du langage garanties par ECMAScript 2024. Vérifiez leur prise en charge dans votre environnement d’exécution cible.
Exemples
(async () => {
const blob = new Blob(["A\u00E9"]);
const reader = blob.stream().getReader();
let bytesRead = 0;
try {
while (true) {
const { done, value } = await reader.read();
if (done) break;
bytesRead += value.byteLength;
}
} finally {
reader.releaseLock();
}
console.log(`size=${blob.size}; bytesRead=${bytesRead}`);
})().catch((error) => console.error(error));Résultat
size=3; bytesRead=3
En UTF-8, `A` occupe un octet et `é` en occupe deux. Après lecture complète, la somme des `value.byteLength` vaut 3 et correspond à `blob.size`, quel que soit le découpage en blocs.
Leçons associées
- JavaScript · Leçon 4 · Avancé · Version : 4