MMM-AirQuality – Bug fetch failed / ETIMEDOUT

Symptômes

MagicMirror démarre mais log PM2 affiche :
- TypeError: fetch failed
- AggregateError [ETIMEDOUT] dans MMM-AirQuality/helper.js
curl https://api.waqi.info/... fonctionne

Objectif

👉 Contourner fetch de Node en remplaçant l’appel API par https.request.

Étapes rapides

Aller dans le dossier du module
```
cd ~/MagicMirror/modules/MMM-AirQuality
```
Sauvegarder le helper
```
cp helper.js helper.js.bak
```
Éditer helper.js
```
nano helper.js
```

Remplacer tout le contenu

/* MagicMirror²
 * Module: MMM-AirQuality
 *
 * By Christopher Fenner https://github.com/CFenner
 * Patched to use https.request instead of fetch (ETIMEDOUT issue).
 * MIT Licensed.
 */

const https = require("https");
const { URL } = require("url");

module.exports = {
  notifications: {
    DATA: "AIR_QUALITY_DATA",
    DATA_RESPONSE: "AIR_QUALITY_DATA_RESPONSE",
  },

  start: function () {
    console.log("AirQuality helper started ...");
  },

  loadData: function (payload) {
    const self = this;
    const urlString = `https://${payload.config.apiBase}${payload.config.dataEndpoint}${payload.config.location}/?token=${payload.config.token}`;

    console.log(`AirQuality-Fetcher (https): ${urlString}`);

    let url;
    try {
      url = new URL(urlString);
    } catch (e) {
      console.error("AirQuality-Fetcher: invalid URL", e);
      self.sendSocketNotification(self.notifications.DATA_RESPONSE, {
        payloadReturn: null,
        status: "ERROR",
        identifier: payload.identifier,
      });
      return;
    }

    const options = {
      hostname: url.hostname,
      port: 443,
      path: url.pathname + url.search,
      method: "GET",
      timeout: 10000, // 10s
    };

    const req = https.request(options, (res) => {
      let data = "";

      res.on("data", (chunk) => {
        data += chunk;
      });

      res.on("end", () => {
        try {
          const json = JSON.parse(data);
          self.sendSocketNotification(self.notifications.DATA_RESPONSE, {
            payloadReturn: json,
            status: "OK",
            identifier: payload.identifier,
          });
        } catch (err) {
          console.error("AirQuality-Fetcher: JSON parse error", err);
          self.sendSocketNotification(self.notifications.DATA_RESPONSE, {
            payloadReturn: null,
            status: "ERROR",
            identifier: payload.identifier,
          });
        }
      });
    });

    req.on("error", (err) => {
      console.error("AirQuality-Fetcher: https error", err);
      self.sendSocketNotification(self.notifications.DATA_RESPONSE, {
        payloadReturn: null,
        status: "ERROR",
        identifier: payload.identifier,
      });
    });

    req.on("timeout", () => {
      console.error("AirQuality-Fetcher: request timeout");
      req.destroy();
      self.sendSocketNotification(self.notifications.DATA_RESPONSE, {
        payloadReturn: null,
        status: "TIMEOUT",
        identifier: payload.identifier,
      });
    });

    req.end();
  },

  socketNotificationReceived: function (notification, payload) {
    switch (notification) {
      case this.notifications.DATA:
        console.log(
          `AirQuality-Fetcher: Loading data of ${payload.config.location} for module ${payload.identifier}`
        );
        this.loadData(payload);
        break;
    }
  },
};

Redémarrer MagicMirror
```
pm2 restart mm
```
Vérifier
- Plus d’erreur fetch failed / ETIMEDOUT
- MMM-AirQuality affiche à nouveau les données

À noter

En cas de mise à jour du module, le patch peut être écrasé → réappliquer helper.js patché.