CSS Loader _ Invalid options object 문제

 서적으로 공부 중 서버 사이드 프로그래밍(Server-side Programming) 파트에서 다음과 같은 에러가 발생하였다.

 

ValidationError: Invalid options object. CSS Loader has been initialized using an options object that does not match the API schema. -options has an unknown property 'onlyLocals'.

 

본 에러는 웹팩으로 빌드를 어떤 방식으로 진행할지와 관련되어, 서버 전용 환경 설정을 해주는 webpack.config.server 소스 코드 상에서

발생한 문제이다.

CSS Loader 옵션 설정 중 onlyLocals를 true로 명시해주면 실제 CSS파일은 생성하지 않고 식별자로서의 기능만 주어지는데, 빌드를 해보면 해당 옵션이 존재하지 않다는 오류 메세지가 떴다.

 

webpack.js.org/loaders/css-loader/

css-loader | webpack

이에 공식 문서를 참조하여, 관련 옵션이 onlyLocals가 아닌 options 내부에 modules 프로퍼티를 사용하고 내장 프로퍼티로 exportOnlyLocals를 true로 바꾸었더니 문제 없이 빌드가 되었다.

공식문서_exportOnlyLocals

교재의 내용이 잘못 기재되어 있는지 확인하기 위해 추가로 관련 레퍼런스를 찾아본 결과, 오히려 exportOnlyLocals 옵션이 onlyLocals 옵션으로 바뀌었음을 확인할 수 있었다.

github.com/webpack-contrib/css-loader/pull/957/files

feat: `exportOnlyLocals` was remove in favor new `onlyLocals` option by alexander-akait · Pull Request #957 · webpack-contrib/

버전 상의 문제로 인해 현재 이러한 문제가 발생한 것 같은데 향후 정확한 원인이 무엇인지 확인하게 되면 관련 사항을 추가하고자 한다.