...
Eroare Node.js · Module ES: import, export și "type": "module"

TypeError: Cannot assign to read only property 'port' of object '[object Module]'

Pe scurt

Î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.

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

Ce înseamnă

import * as setari from "./setari.js" îți dă obiectul spațiu de nume al modulului ([object Module]): o vedere asupra exporturilor, nu o copie. Proprietățile lui sunt legături vii (live bindings) către variabilele din modul și sunt doar pentru citire. Doar modulul care a exportat o variabilă o poate schimba.

Așa că setari.port = 8080 dă Cannot assign to read only property 'port' of object '[object Module]'. Modulele ES rulează mereu în modul strict, de aceea primești o eroare și nu doar o atribuire ignorată.

Apare des la trecerea de la CommonJS: acolo require întorcea un obiect obișnuit, pe care îl puteai modifica (config.port = 8080). Aceeași idee: import { port } from "./setari.js"; port = 8080 dă TypeError: Assignment to constant variable.

De ce apare: cauzele frecvente

1Modifici direct un export

Greșit
JavaScript
import * as setari from "./setari.js";
setari.port = 8080;
Corect
JavaScript
import * as setari from "./setari.js";
const config = { ...setari, port: 8080 };

Copia este un obiect obișnuit, pe care îl poți modifica fără să atingi modulul.

2Starea partajată trebuie schimbată din modul

Greșit
JavaScript
// contor.js
export let vizite = 0;

// index.js
import * as contor from "./contor.js";
contor.vizite++;
Corect
JavaScript
// contor.js
export let vizite = 0;
export function inregistreaza() { vizite++; }

// index.js
import * as contor from "./contor.js";
contor.inregistreaza();

Modulul care deține variabila o poate modifica, iar toți cei care o importă văd noua valoare prin legătura vie.

3Exportă un obiect, dacă vrei să-l modifici

Greșit
JavaScript
// config.js
export const port = 3000;
Corect
JavaScript
// config.js
export const config = { port: 3000 };

// index.js
import { config } from "./config.js";
config.port = 8080;

Legătura config e doar pentru citire, dar obiectul spre care arată e obișnuit, deci îi poți schimba proprietățile.

Repară tu

Repară eroarea, direct în pagină

Programul importă setările implicite din setari.js și vrea să pornească pe portul 8080, dar modifică direct exportul și primește TypeError: Cannot assign to read only property 'port' of object '[object Module]'. Construiește în schimb un obiect nou config, copiat din setări, cu portul schimbat, și afișează valorile din el.

Codul care dă eroarea
JavaScript
import * as setari from "./setari.js";

setari.port = 8080;

console.log(`Port: ${setari.port}`);
console.log(`Mediu: ${setari.mediu}`);
console.log(`Implicit: ${setari.port === 3000 ? "da" : "nu"}`);
După reparație, programul afișează
Port: 8080
Mediu: dezvoltare
Implicit: da
Indiciu

const config = { ...setari, port: 8080 }; și apoi folosește config în loc de setari.

Alte forme ale mesajului

  • TypeError: Cannot assign to read only property 'default' of object '[object Module]'
  • TypeError: Assignment to constant variable.
  • TypeError: Cannot add property x, object is not extensible

Cum o eviți pe viitor

  • Tratează importurile ca pe constante: le citești, nu le modifici.
  • Când ai nevoie de o variantă modificată a setărilor, construiește un obiect nou: { ...setari, port: 8080 }.
  • Pentru stare comună între module (contoare, cache), exportă funcții care o modifică.
  • La trecerea de la require la import, caută în cod atribuirile pe obiectele importate.

Întrebări frecvente

De ce în CommonJS mergea?

require întoarce obiectul module.exports, un obiect JavaScript obișnuit. Modulele ES dau o vedere doar pentru citire asupra exporturilor, ca să nu poată fi schimbate din afară.

Dacă modulul își schimbă singur variabila, văd noua valoare?

Da. Importurile sunt legături vii: după ce contor.js face vizite++, contor.vizite din alt modul arată noua valoare.

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.