바쁜 분은 이것만
const로 만든 변수에=,+=,++로 다시 값을 넣으면 나는 에러 → 바뀌는 값이면let- const 객체·배열의 속성·요소 변경(
obj.a = 1,arr.push())은 에러가 아님. 막고 싶으면Object.freeze() for (const i = 0; ...; i++)는 에러,for...of·for...in은 const 써도 OK
TypeError: Assignment to constant variable.은 "상수(const)로 만든 변수에 값을 다시 넣으려 했다"는 뜻입니다. const는 한 번 값을 담으면 그 변수가 가리키는 대상을 바꿀 수 없어요. 그런데 const로 만든 객체의 속성은 또 잘 바뀌어서 헷갈리기 쉽습니다. Node.js v26에서 하나씩 직접 실행해 정리했어요.
1. 가장 흔한 경우: const 변수에 다시 값 넣기
const count = 0;
count = count + 1;
console.log(count);
file://~/work/c1.mjs:2
count = count + 1;
^
TypeError: Assignment to constant variable.
at file://~/work/c1.mjs:2:7
에러 위치의 ^가 =를 가리키고 있죠. +=, -=, ++도 모두 "다시 넣기"라서 똑같이 막힙니다.
const total = 10;
total += 5;
file://~/work/c2.mjs:2
total += 5;
^
TypeError: Assignment to constant variable.
at file://~/work/c2.mjs:2:7
값이 바뀌어야 하는 변수라면 처음부터 let으로 선언하면 됩니다.
let count = 0;
count = count + 1;
count += 5;
console.log(count);
// 다른 값이 필요하면 새 const로 받기
const price = 1000;
const priceWithTax = price * 1.1;
console.log(priceWithTax);
6
1100
값을 계산해서 한 번만 쓰는 거라면 원래 변수를 바꾸지 말고 priceWithTax처럼 새 이름의 const에 담는 것도 좋은 방법이에요. 어떤 값이 어디서 바뀌었는지 추적하기 쉬워집니다.
2. const 객체·배열은 왜 속성 변경이 되나
이 에러를 처음 만나면 "const 배열에 push는 되던데?" 하는 의문이 생깁니다. 직접 해 보면 이렇습니다.
const user = { name: "kim", age: 20 };
user.age = 21; // 속성 변경 → OK
user.city = "Seoul"; // 속성 추가 → OK
console.log(user);
const nums = [1, 2, 3];
nums.push(4); // 배열 요소 추가 → OK
nums[0] = 100; // 요소 변경 → OK
console.log(nums);
try {
nums = [9, 9]; // 변수 자체를 다른 배열로 → 에러
} catch (e) {
console.log(e.name + ": " + e.message);
}
try {
user = { name: "lee" };
} catch (e) {
console.log(e.name + ": " + e.message);
}
{ name: 'kim', age: 21, city: 'Seoul' }
[ 100, 2, 3, 4 ]
TypeError: Assignment to constant variable.
TypeError: Assignment to constant variable.
const가 막는 건 변수가 가리키는 대상을 바꾸는 것뿐이에요. user라는 이름표가 처음 만든 객체에 붙어 있는 건 그대로이고, 그 객체 안의 내용물(age, city)을 고치는 건 막지 않습니다. 반대로 nums = [9, 9]처럼 이름표를 다른 배열로 옮기려 하면 에러가 나요.
user.age = 21,nums.push(4),nums[0] = 100→ 내용물 변경, OKuser = {...},nums = [...]→ 변수 자체를 바꿈, 에러
원본은 두고 바뀐 값을 쓰고 싶다면 스프레드 문법으로 새 객체·배열을 만들어 새 이름에 담으면 됩니다.
const user = { name: "kim", age: 20 };
const older = { ...user, age: 21 }; // 새 객체를 만들어 새 이름에 담기
console.log(user, older);
const nums = [1, 2, 3];
const more = [...nums, 4];
console.log(nums, more);
{ name: 'kim', age: 20 } { name: 'kim', age: 21 }
[ 1, 2, 3 ] [ 1, 2, 3, 4 ]
스프레드로 복사할 때 안쪽 객체까지 복사되는지는 자바스크립트 배열 복사 (스프레드) 글에 따로 정리해 두었어요.
3. for문에서 const를 쓴 경우
습관처럼 const를 쓰다 보면 for문에서도 이 에러를 만납니다.
for (const i = 0; i < 3; i++) {
console.log(i);
}
0
file://~/work/c4.mjs:1
for (const i = 0; i < 3; i++) {
^
TypeError: Assignment to constant variable.
at file://~/work/c4.mjs:1:27
재미있는 점은 0이 한 번 찍힌 다음에 에러가 난다는 거예요. 첫 바퀴는 문제없이 돌고, 다음 바퀴로 넘어가며 i++로 i를 바꾸려는 순간 막힙니다. 숫자를 늘려 가는 for문은 let이어야 해요.
반면 for...of와 for...in은 const를 써도 됩니다.
for (const n of [10, 20, 30]) {
console.log("for...of:", n);
}
for (const key in { a: 1, b: 2 }) {
console.log("for...in:", key);
}
for (let i = 0; i < 3; i++) {
console.log("let i:", i);
}
for...of: 10
for...of: 20
for...of: 30
for...in: a
for...in: b
let i: 0
let i: 1
let i: 2
for...of·for...in은 바퀴마다 새 변수를 만들어 값을 담기 때문에 다시 넣기가 일어나지 않아요. 기존 변수를 ++로 바꾸는 일반 for문만 let이 필요합니다.
4. import한 변수에 값을 넣은 경우
다른 파일에서 let으로 내보낸 변수라도, 가져온 쪽에서는 값을 넣을 수 없어요. 메시지가 똑같아서 헷갈리기 쉬운 경우입니다.
// counter.mjs
export let count = 0;
// c10.mjs
import { count } from "./counter.mjs";
count = 1;
file://~/work/c10.mjs:2
count = 1;
^
TypeError: Assignment to constant variable.
at file://~/work/c10.mjs:2:7
import로 받은 이름은 읽기 전용이라서 const처럼 취급됩니다. 값을 바꾸고 싶으면 counter.mjs 안에 export function setCount(v) { count = v; } 같은 함수를 두고 그걸 부르는 방식으로 바꿔야 해요.
5. 비슷한 에러: Missing initializer in const declaration
const는 선언할 때 값을 같이 줘야 합니다. 나중에 넣으려고 비워 두면 실행 전에 바로 막혀요.
const answer;
answer = 42;
file://~/work/c12.mjs:1
const answer;
^^^^^^
SyntaxError: Missing initializer in const declaration
이건 TypeError가 아니라 SyntaxError라서 파일의 첫 줄도 실행되지 않습니다. 값이 나중에 정해지는 변수면 let answer;로 쓰면 돼요.
6. 속성 변경까지 막고 싶다면: Object.freeze
설정값처럼 아무도 건드리면 안 되는 객체는 Object.freeze()로 얼려 둘 수 있습니다. 다만 동작이 실행 방식에 따라 달라요. 먼저 일반 스크립트(.cjs, 비엄격 모드)입니다.
const config = Object.freeze({ mode: "dev", retry: 3 });
config.mode = "prod"; // 일반 스크립트(비엄격)에서는 조용히 무시
config.debug = true;
console.log(config);
console.log("isFrozen:", Object.isFrozen(config));
{ mode: 'dev', retry: 3 }
isFrozen: true
에러 없이 지나가지만 값은 하나도 안 바뀌었어요. 같은 코드를 ES 모듈(.mjs)에서 돌리면 모듈은 항상 strict mode라 에러가 납니다.
file://~/work/c7.mjs:2
config.mode = "prod"; // .mjs(모듈)는 strict mode라 에러
^
TypeError: Cannot assign to read only property 'mode' of object '#<Object>'
at file://~/work/c7.mjs:2:13
메시지가 Assignment to constant variable.이 아니라 Cannot assign to read only property로 다르니 구분해 두세요. 앞의 것은 변수를, 뒤의 것은 얼린 객체의 속성을 바꾸려 했다는 뜻이에요.
주의할 점은 freeze가 겉 한 겹만 언다는 겁니다.
const settings = Object.freeze({ mode: "dev", db: { host: "localhost" } });
settings.db.host = "10.0.0.1"; // 안쪽 객체는 얼지 않음
console.log(settings.db.host);
const list = Object.freeze([1, 2, 3]);
try {
list.push(4);
} catch (e) {
console.log(e.name + ": " + e.message);
}
10.0.0.1
TypeError: Cannot add property 3, object is not extensible
안쪽의 db 객체는 그대로 바뀌었어요. 배열도 freeze하면 push가 막힙니다(이건 메서드 안에서 에러를 던져서 .mjs·.cjs 구분 없이 에러예요). 안쪽까지 다 얼리려면 직접 돌면서 freeze하는 함수를 씁니다.
function deepFreeze(obj) {
for (const value of Object.values(obj)) {
if (typeof value === "object" && value !== null) deepFreeze(value);
}
return Object.freeze(obj);
}
const settings = deepFreeze({ mode: "dev", db: { host: "localhost" } });
try {
settings.db.host = "10.0.0.1";
} catch (e) {
console.log(e.name + ": " + e.message);
}
console.log(settings.db.host);
TypeError: Cannot assign to read only property 'host' of object '#<Object>'
localhost
정리
| 코드 | 동작 | 고치는 법 |
|---|---|---|
const a = 0; a = 1; / a += 1 / a++ |
TypeError: Assignment to constant variable. | let으로 선언하거나 새 const에 담기 |
const obj = {}; obj.a = 1; / arr.push() |
에러 없음 (내용물 변경) | 막으려면 Object.freeze() |
obj = {...} / arr = [...] |
TypeError: Assignment to constant variable. | const next = { ...obj, a: 2 } |
for (const i = 0; ...; i++) |
첫 바퀴 후 TypeError | let i (for...of·for...in은 const OK) |
| import한 변수에 값 넣기 | TypeError: Assignment to constant variable. | 내보낸 파일에 값 바꾸는 함수 두기 |
const a; |
SyntaxError: Missing initializer | 값 같이 주기 또는 let a; |
| 얼린 객체 속성 변경 | 모듈·strict: TypeError(read only) / 비엄격: 조용히 무시 | 안쪽까지 막으려면 deepFreeze |
참고: MDN Web Docs — const, TypeError: invalid assignment to const "x", for...of, Object.freeze(), Object.isFrozen(), Strict mode / ECMAScript 언어 명세 — Module Namespace·import 바인딩(읽기 전용)
