...
Eroare Node.js · Express

TypeError: Cannot set property query of #<IncomingMessage> which has only a getter

Pe scurt

În Express 5, req.query e doar pentru citire (un getter), așa că req.query = {...} dă eroare. Apare în middleware-uri proprii sau în pachete vechi scrise pentru Express 4. Pune valorile prelucrate în altă proprietate, de exemplu req.filtre sau res.locals.filtre.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În Express 4, req.query era o proprietate obișnuită, setată o dată la începutul cererii, iar mulți scriau req.query = { ...req.query, pagina: 1 } ca să adauge valori implicite sau să curețe parametrii. În Express 5, req.query a devenit un getter: e calculat din adresă de fiecare dată când îl citești și nu are setter.

În cod strict (module ES, "use strict", clase, majoritatea pachetelor), o atribuire pe o proprietate care are doar getter dă TypeError: Cannot set property query of #<IncomingMessage> which has only a getter. IncomingMessage e clasa din Node pe care se bazează cererea Express. În cod nestrict, atribuirea e ignorată în tăcere, și valorile tale implicite pur și simplu nu apar.

Apare des după actualizarea la Express 5, în middleware-uri de validare, paginare sau „sanitizare” (de exemplu pachete vechi de curățare a parametrilor).

De ce apare: cauzele frecvente

1Middleware care rescrie req.query

Greșit
JavaScript
app.use((req, res, next) => {
  req.query = { pagina: "1", ...req.query };
  next();
});
Corect
JavaScript
app.use((req, res, next) => {
  req.filtre = { pagina: "1", ...req.query };
  next();
});

O proprietate nouă (req.filtre) poate fi setată liber; req.query rămâne exact ce a trimis clientul.

2Pachet scris pentru Express 4

Greșit
JavaScript
// un pachet vechi de sanitizare face intern:
// req.query = curata(req.query);
app.use(sanitizeVechi());
Corect
JavaScript
// actualizează pachetul la o versiune compatibilă cu Express 5
// sau curăță tu parametrii într-o proprietate nouă
app.use((req, res, next) => {
  res.locals.query = curata(req.query);
  next();
});

Pachetele care atribuie req.query trebuie actualizate; până atunci poți face prelucrarea tu, în altă proprietate.

3Modificarea unei chei din query

Greșit
JavaScript
req.query.pagina = Number(req.query.pagina) || 1;
Corect
JavaScript
const pagina = Number(req.query.pagina) || 1;

Obiectul întors de getter e recalculat la fiecare citire, deci modificările pe el se pierd. Păstrează valorile prelucrate în variabile proprii.

Repară tu

Repară eroarea, direct în pagină

Middleware-ul de paginare (modul ES, Express 5) vrea să adauge valori implicite rescriind req.query, dar req.query are doar getter, iar cererea se termină cu 500 și TypeError: Cannot set property query of #<IncomingMessage> which has only a getter. Pune parametrii cu valorile implicite în req.paginare și folosește-i în rută, ca testul să afișeze ambele răspunsuri.

Codul care dă eroarea
JavaScript
import express from "express";

const app = express();
const produse = ["Cafea", "Ceai", "Cană", "Lapte", "Zahăr"];

app.use((req, res, next) => {
  req.query = { pagina: "1", limita: "2", ...req.query };
  next();
});

app.get("/api/produse", (req, res) => {
  const pagina = Number(req.query.pagina);
  const limita = Number(req.query.limita);
  res.json(produse.slice((pagina - 1) * limita, pagina * limita));
});

app.use((err, req, res, next) => {
  console.error(`Eroare: ${err.message}`);
  res.status(err.status || 500).json({ eroare: err.message });
});

const server = app.listen(3000, async () => {
  for (const cale of ["/api/produse", "/api/produse?pagina=2"]) {
    const r = await fetch(`http://localhost:3000${cale}`);
    console.log(`${cale} -> ${r.status} ${r.ok ? await r.text() : ""}`);
    if (!r.ok) process.exitCode = 1;
  }
  server.close();
});
După reparație, programul afișează
/api/produse -> 200 ["Cafea","Ceai"]
/api/produse?pagina=2 -> 200 ["Cană","Lapte"]
Indiciu

Înlocuiește req.query = ... cu req.paginare = ... și citește req.paginare în rută.

Alte forme ale mesajului

  • TypeError: Cannot set property query of [object Object] which has only a getter
  • TypeError: Cannot set property query of #<Object> which has only a getter
  • TypeError: Cannot set property params of #<IncomingMessage> which has only a getter

Cum o eviți pe viitor

  • Tratează req.query, req.params și antetele ca date de intrare: le citești, nu le rescrii.
  • Pune valorile prelucrate în req.filtre, req.paginare sau res.locals.
  • Înainte de trecerea la Express 5, caută în proiect req.query = și verifică pachetele de middleware.
  • Citește ghidul de migrare Express 4 → 5: lista schimbărilor e scurtă.

Întrebări frecvente

De ce în alt proiect atribuirea nu dă eroare, dar nici nu merge?

În cod nestrict (CommonJS fără "use strict"), atribuirea pe un getter fără setter e ignorată în tăcere. req.query rămâne neschimbat, iar valorile tale nu ajung în rută.

Ce e res.locals?

Un obiect gol creat de Express pentru fiecare cerere, gândit exact pentru a transmite date între middleware-uri și rută.

Erori înrudite

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Node.js de la zero, cu exerciții la fiecare lecție

Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.