Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Blob : taille en octets et lecture en flux

Blob stocke des données binaires immuables. La propriété Blob.size indique leur taille en octets, tandis que Blob.stream() rend les données accessibles pour une lecture asynchrone, morceau par morceau, au moyen d’un ReadableStream.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new Blob(blobParts, options)
blob.size
blob.stream()

Blob est un objet qui contient des données brutes immuables. Le constructeur new Blob(blobParts, options) rassemble les parties fournies en un seul objet. File hérite des fonctionnalités de Blob, tout en ajoutant des informations liées aux fichiers.

Blob.size désigne la propriété d’instance consultée sous la forme blob.size, sans parenthèses. Elle est en lecture seule et renvoie le nombre d’octets de données, et non le nombre de caractères du texte. Obtenir la taille ne nécessite pas de lire le contenu de façon asynchrone.

Blob.stream désigne la méthode d’instance appelée sous la forme blob.stream(), sans argument. Elle renvoie un ReadableStream, et non une promesse contenant l’ensemble du contenu. Un lecteur obtenu avec getReader() permet de récupérer des morceaux d’octets de façon asynchrone. Dans l’exemple, leur byteLength est additionné jusqu’à ce que done vaille true ; aucune quantité ni taille particulière de morceaux n’est supposée. La lecture en flux ne modifie pas les données du Blob.

Il s’agit d’interfaces de Web API, et non de fonctionnalités rattachées à une édition d’ECMAScript. MDN indique que Blob.size est largement disponible depuis juillet 2015 et Blob.stream() depuis avril 2021. Les deux sont également disponibles dans les Web Workers. Vérifiez séparément la prise en charge par les navigateurs ciblés ; la présence de Node 24 dans un dépôt ne prouve pas cette prise en charge.

Exemples

async function main() {
  const blob = new Blob([new Uint8Array([65, 66, 67])]);
  const reader = blob.stream().getReader();
  let total = 0;

  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) break;
      total += value.byteLength;
    }
  } finally {
    reader.releaseLock();
  }

  console.log(`size=${blob.size}`);
  console.log(`read=${total}`);
  console.log(`match=${total === blob.size}`);
}

main().catch(console.error);

Résultat

size=3
read=3
match=true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources