[!NOTE] Historische Bibliothek: Q war eine grundlegende Promises/A+-Implementierung, bevor native ES2015-Promises und
async/awaitin JavaScript-Engines standardisiert wurden.
Q ist eine Promise-Bibliothek für Node.js und Browser.
Promises erstellen
const Q = require('q');
function asyncAction() {
const deferred = Q.defer();
fs.readFile('data.txt', 'utf8', (err, data) => {
if (err) deferred.reject(err);
else deferred.resolve(data);
});
return deferred.promise;
}
Nodebacks (Node.js Callbacks) konvertieren
Q bietet Hilfsfunktionen, um Standard-Node-Callback-Signaturen (err, result) in Promises umzuwandeln:
const fs = require('fs');
// Q.nfcall: Node Function Call
Q.nfcall(fs.readFile, 'file.txt', 'utf-8')
.then((data) => console.log(data))
.catch((err) => console.error(err));
// Q.denodeify: Wrapper-Funktion, die ein Promise zurückgibt
const readFile = Q.denodeify(fs.readFile);
readFile('file.txt', 'utf-8').then(console.log);
Array-Kombinatoren
// Q.all: Wartet, bis alle Promises erfolgreich aufgelöst wurden
Q.all([stepA(), stepB()])
.then(([resA, resB]) => {
console.log(resA, resB);
});
// Q.allSettled: Wartet auf den Abschluss aller Promises, unabhängig vom Ergebnis
Q.allSettled([stepA(), stepB()])
.then((results) => {
results.forEach((r) => {
if (r.state === 'fulfilled') console.log(r.value);
else console.error(r.reason);
});
});