피드로 돌아가기
Node.js 25.2.1 (Current)
Node.js BlogNode.js Blog
Backend

Node.js 25.2.1이 localStorage 접근 시 예외 발생 동작을 되돌려 실험적 API의 과도한 호환성 파괴 방지

Node.js 25.2.1 (Current)

2025년 11월 17일3intermediate

Context

Node.js 25.2.0에서 Web Storage API의 실험적 구현으로 localStorage 접근 시 예외를 발생시키도록 변경했으나, 이 변화가 semver-minor 릴리스로는 너무 파괴적이라는 사용자 피드백을 받았다.

Technical Solution

  • localStorage 접근 시 예외 발생 동작 되돌림: #60750 커밋으로 이전 동작 방식 복구
  • Web Storage 지원 실험적 상태 명확화: 문서, 소스 코드, 라이브러리에 실험적 API임을 명시 (#60708)
  • 기술 부채 이연: 호환성 파괴 변경을 Node.js 26.0.0 메이저 릴리스로 계획 이동
  • RSA-PSS 암호화 기본값 명세 준수: 문서화된 saltLength 기본값 사용 확인 (#60662)
  • V8 엔진 백포트: 상위 V8 버전의 버그 수정 사항 현재 버전에 적용 (#60654)

Key Takeaway

실험적 API의 경우 명세 준수 강제보다는 사용자 영향도를 먼저 검토하고, 호환성 파괴는 메이저 버전으로 예약하는 것이 커뮤니티 신뢰 유지의 핵심이다.


오픈소스 런타임/프레임워크 유지보수자는 실험적 기능에 대한 breaking change를 semver-minor로 릴리스하기 전에 실제 사용자 영향도를 수집하고, 필요시 메이저 버전으로 연기하는 방식으로 커뮤니티 신뢰도를 확보할 수 있다.

원문 읽기