Q.js Promises Σημειώσεις

[!NOTE] Ιστορική Βιβλιοθήκη: Το Q ήταν μια θεμελιώδης υλοποίηση Promises/A+ πριν τα εγγενή Promises του ES2015 και το async/await τυποποιηθούν στις μηχανές JavaScript.

Το Q είναι μια βιβλιοθήκη υποσχέσεων (promises) σχεδιασμένη για Node.js και προγράμματα περιήγησης.

Δημιουργία Promises

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)

Το Q παρέχει βοηθητικά προγράμματα για τη μετατροπή τυπικών υπογραφών callback του Node (err, result) σε promises:

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: Τυλίγει τη συνάρτηση callback σε συνάρτηση που επιστρέφει promise
const readFile = Q.denodeify(fs.readFile);
readFile('file.txt', 'utf-8').then(console.log);

---

Συνδυαστές Πινάκων (Array Combinators)

// Q.all: Περιμένει την επιτυχή επίλυση όλων
Q.all([stepA(), stepB()])
  .then(([resA, resB]) => {
    console.log(resA, resB);
  });

// Q.allSettled: Περιμένει να ολοκληρωθούν όλα ανεξάρτητα από επιτυχία ή αποτυχία
Q.allSettled([stepA(), stepB()])
  .then((results) => {
    results.forEach((r) => {
      if (r.state === 'fulfilled') console.log(r.value);
      else console.error(r.reason);
    });
  });

---

Αναφορές

• Αποθετήριο Q στο GitHub
• JavaScript Promises Σημειώσεις