CKTIS / JavaScript
ReadableStream — lire des données par morceaux
ReadableStream permet de consommer des données par morceaux. Un lecteur les récupère de manière asynchrone sans devoir d’abord rassembler l’ensemble des données.
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 ReadableStream(underlyingSource?, strategy?)ReadableStream fait partie du Streams Standard, et non d’ECMAScript. Les flux par défaut transportent des valeurs JavaScript arbitraires ; type: "bytes" permet les lectures BYOB dans des tampons fournis par le consommateur.
Les sources utilisent enqueue() pour ajouter des morceaux. close() permet à la file d’attente de se vider ; les erreurs font rejeter les lectures. read() renvoie une promesse pour { value, done }.
getReader() verrouille le flux pour un seul lecteur. releaseLock() déverrouille le flux sans annuler la source. Avec un lecteur actif, annulez via reader.cancel() ; l’annulation supprime la file d’attente.
pull() permet une production à la demande ; des appels inconditionnels à enqueue() peuvent faire grossir la file malgré la contre-pression. Vérifiez la prise en charge dans l’environnement cible ; Node 24 ne prouve pas la prise en charge par les navigateurs.
Exemples
async function main() {
const stream = new ReadableStream({
start(controller) {
controller.enqueue("A");
controller.enqueue("B");
controller.close();
}
});
const reader = stream.getReader();
let text = "";
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
text += value;
}
} finally {
reader.releaseLock();
}
console.log(text);
}
main().catch(console.error);Résultat
AB
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.