TypeError: Cannot set property query of #<IncomingMessage> which has only a getter
Î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
app.use((req, res, next) => {
req.query = { pagina: "1", ...req.query };
next();
});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
// un pachet vechi de sanitizare face intern:
// req.query = curata(req.query);
app.use(sanitizeVechi());// 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
req.query.pagina = Number(req.query.pagina) || 1;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ă 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.
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();
});/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ă.
Reparația
import express from "express";
const app = express();
const produse = ["Cafea", "Ceai", "Cană", "Lapte", "Zahăr"];
app.use((req, res, next) => {
req.paginare = { pagina: "1", limita: "2", ...req.query };
next();
});
app.get("/api/produse", (req, res) => {
const pagina = Number(req.paginare.pagina);
const limita = Number(req.paginare.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();
});De ce merge
În Express 5, req.query e calculat din adresă de fiecare dată când îl citești și nu poate fi înlocuit; într-un modul ES (cod strict), încercarea aruncă TypeError, iar Express răspunde cu 500. O proprietate nouă pe cerere, req.paginare, se poate seta liber: middleware-ul pune acolo valorile implicite peste care se suprapun parametrii primiți, iar ruta le citește de acolo.
Alte forme ale mesajului
TypeError: Cannot set property query of [object Object] which has only a getterTypeError: Cannot set property query of #<Object> which has only a getterTypeError: 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.paginaresaures.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
TypeError: Cannot destructure property 'nume' of 'req.body' as it is undefined. req.body este undefined pentru că Express nu citește singur corpul cererii: lipsește app.use(express.json()) (sau express.urlencoded() pentru formulare), e pus după rute, ori clientul nu trimite Content-Type: application/json. Adaugă middleware-ul înaintea rutelor. TypeError: res.status is not a function Variabila res nu e obiectul răspuns Express: de obicei parametrii handler-ului sunt inversați ((res, req) în loc de (req, res)), handler-ul de erori are doar 3 parametri în loc de 4, sau folosești modulul http simplu, unde res nu are status() și json(). Verifică ordinea: (req, res, next) și (err, req, res, next). TypeError: Cannot assign to read only property 'port' of object '[object Module]' Încerci să modifici o valoare importată dintr-un modul ES. Importurile sunt doar pentru citire: nu poți scrie setari.port = 8080. Fă o copie (const config = { ...setari, port: 8080 }) sau exportă din modul o funcție care schimbă valoarea. Î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.
