[!NOTE] Biblioteka historyczna: Q było fundamentalną implementacją standardu Promises/A+ przed wprowadzeniem natywnych obietnic w ES2015 oraz słów kluczowych
async/awaitdo silników JavaScript.
Q to biblioteka obietnic (promises) stworzona z myślą o Node.js i przeglądarkach internetowych.
Tworzenie obietnic
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;
}
Konwersja Nodebacks (Callbacki w Node.js)
Q udostępnia narzędzia do konwertowania standardowych funkcji callback w Node (err, result) na obietnice:
const fs = require('fs');
// Q.nfcall: Bezpośrednie wywołanie funkcji w stylu Node
Q.nfcall(fs.readFile, 'file.txt', 'utf-8')
.then((data) => console.log(data))
.catch((err) => console.error(err));
// Q.denodeify: Opakowuje funkcję callback w funkcję zwracającą obietnicę
const readFile = Q.denodeify(fs.readFile);
readFile('file.txt', 'utf-8').then(console.log);
Kombinatory tablicowe
// Q.all: Czeka na pomyślne rozwiązanie wszystkich obietnic
Q.all([stepA(), stepB()])
.then(([resA, resB]) => {
console.log(resA, resB);
});
// Q.allSettled: Czeka na zakończenie wszystkich obietnic niezależnie od wyniku
Q.allSettled([stepA(), stepB()])
.then((results) => {
results.forEach((r) => {
if (r.state === 'fulfilled') console.log(r.value);
else console.error(r.reason);
});
});