Lighthouse의 Legacy JavaScript: 해결할 것과 그대로 둘 것
모든 방문자가 다운로드하는 구형 브라우저용 코드입니다. Lighthouse가 지적하는 파일이 누구의 것인지, WordPress, Shopify, Next.js, 자체 빌드에서 어떻게 조치해야 하는지 설명합니다.
Legacy JavaScript를 해결해야 할까요?
Lighthouse는 이전에 Avoid serving legacy JavaScript to modern browsers로 표시하던 항목을 이제 Legacy JavaScript("폴리필과 트랜스폼을 사용하면 구형 브라우저에서 최신 JavaScript 기능을 사용할 수 있습니다")로 표시합니다. 이 항목은 거의 아무도 쓰지 않는 브라우저를 위한 코드가 포함된 스크립트를 나열하며, 모든 방문자가 이 불필요한 코드를 다운로드하게 됩니다. 직접 작성한 JavaScript는 Baseline Widely available 브라우저를 대상으로 빌드해 해결하고, 플러그인이나 벤더 파일은 업데이트하거나 교체하거나 그대로 두세요.
빠른 해결을 원한다면 WordPress, Shopify, Next.js, 자체 빌드 항목으로 바로 이동하세요.
Legacy JavaScript는 스크립트에서 무엇을 찾아낼까요?
안내 문구는 다음과 같습니다: "폴리필과 트랜스폼을 사용하면 구형 브라우저에서 최신 JavaScript 기능을 사용할 수 있습니다. 그러나 상당수는 최신 브라우저에 필요하지 않습니다. 구형 브라우저를 반드시 지원해야 하는 경우가 아니라면, Baseline 기능을 트랜스파일하지 않도록 JavaScript 빌드 과정을 수정하는 것이 좋습니다."

PageSpeed Insights 설정으로 실행한 여객선 테스트 페이지의 예약 위젯: 스크립트 하나가 22 KiB를 차지합니다.
Lighthouse는 스크립트를 도메인별로 그룹화하고(자체 스크립트는 "1st Party", 벤더 스크립트는 회사 이름) 각각의 "Wasted bytes"를 표시합니다. 각 스크립트 아래에 표시되는 Array.prototype.find나 Object.entries 같은 기능 이름의 줄은 폴리필입니다. 해당 기능이 없는 브라우저에 기능을 추가해 주는 코드입니다. @babel/plugin-transform으로 시작하는 줄은 트랜스폼입니다. 파일을 빌드한 도구인 Babel이 클래스나 async 함수 같은 최신 코드를 헬퍼 함수를 사용하는 구형 JavaScript로 다시 작성한 결과입니다.
표시되는 킬로바이트 수치는 추정치이며 실제 파일 크기보다 클 수 있습니다. 단일 기능을 위한 작은 fallback 하나만 있어도 대표적인 폴리필 라이브러리인 core-js의 공통 기반 코드가 포함된 것으로 계산됩니다. 그래서 실제 다운로드 크기가 4 KiB인 파일이 10 KiB로 잡히기도 합니다.
빨간색 표시는 목록의 스크립트가 가장 큰 요소(LCP)나 첫 콘텐츠(FCP)와 동시에 다운로드된다는 의미입니다. 주황색은 단순히 용량만 늘어나고 있음을 뜻합니다. Unscored: Legacy JavaScript 항목 자체는 Performance 점수에 직접 반영되지 않지만, LCP와 FCP는 점수에 반영됩니다.
Legacy JavaScript는 방문자에게 어떤 영향을 미칠까요?
예약 양식, 메뉴, 슬라이더 등 스크립트가 렌더링하는 요소를 보기 위해 방문자는 그만큼 더 기다려야 합니다. 브라우저에 이미 모든 기능이 내장되어 있더라도 불필요한 코드를 다운로드하고 실행합니다. 각 폴리필이 기능 지원 여부를 확인한 뒤 브라우저 자체 버전을 유지하더라도, 바이트 전송과 기능 검사는 페이지를 로드할 때마다 매번 발생합니다.
어느 카페리 회사의 메인 페이지를 본뜬 테스트 페이지에서 동일한 코드로 작성한 React 예약 위젯을 두 번 빌드했습니다. 한 번은 Babel과 core-js를 적용한 Internet Explorer 11용 빌드이고, 다른 한 번은 최신 브라우저용 빌드입니다. 두 버전 모두 중급형 스마트폰 CPU와 동일한 모바일 네트워크 환경(RTT 150 ms, 1.6 Mbps)에서 테스트했습니다:
| 빌드 | 예약 양식 표시 | JavaScript (gzip) | 스크립트 실행 시간 |
|---|---|---|---|
| Internet Explorer 11용 | 1.93초 | 83 kB | 80 ms |
| 최신 브라우저용 | 1.73초 | 49 kB | 50 ms |

적용 전

적용 후
방문자가 링크를 탭한 지 1.8초가 지난 시점의 페리 페이지.
스크립트 단 하나에서 0.2초가 지연되었고, 그중 30 ms는 스크립트 실행 시간이었습니다. defer 처리된 스크립트라도 페이지 상단 이미지와 네트워크 연결을 공유하므로, 여기서 경고가 빨간색으로 표시된 것입니다. core-js 전체가 포함된 번들이나 이런 번들이 여러 개 있는 페이지라면, 이 위젯보다 훨씬 더 많은 불필요한 코드를 다운로드하게 됩니다.
Lighthouse가 지적하는 파일은 누구의 것일까요?
보고서의 파일 주소를 보면 누가 빌드했는지 알 수 있으며, 이에 따라 취할 수 있는 조치도 결정됩니다:
- 자체 번들: 개발팀이 직접 빌드하는 테마나 앱입니다. 빌드 설정 하나만 바꾸고 다시 빌드하면 됩니다(자체 빌드).
- 플러그인 스크립트: WordPress의 경우 주소에서
/wp-content/plugins/뒤에 오는 폴더가 해당 플러그인입니다. Lighthouse에는 MonsterInsights의frontend-gtag.min.js, 상품 및 결제 페이지의 WooCommerce용 Stripe 게이트웨이, 폼 플러그인의 날짜 선택기(WPForms, Ninja Forms, Elementor의 flatpickr) 등이 잡힙니다.wp-polyfill.min.js는 플러그인이 요청할 때 로드되는 WordPress 파일입니다. WooCommerce 블록이나 reCAPTCHA가 켜진 Contact Form 7이 대표적입니다(WordPress). - 벤더 태그(회사 이름 아래에 나열됨): Meta Pixel(
fbevents.js), OneTrust 쿠키 배너, HubSpot 폼 및 피드백 스크립트, Cloudflare가 페이지에 직접 추가하는 Cloudflare Web Analytics 비콘 등이 있습니다. Google Tag Manager와 gtag.js는 나열되지 않습니다. 이 파일들은 해당 벤더만 다시 빌드할 수 있으므로, 태그를 그대로 유지하거나 삭제해야 합니다. Cloudflare Web Analytics는 Cloudflare 대시보드에서 비활성화할 수 있습니다. - Next.js: 모든 Next.js 사이트에는 Next.js 자체 폴리필이 포함된 스크립트가 잡히며,
Array.prototype.at이나Object.hasOwn같은 항목이 표시됩니다.

최신 브라우저용 빌드에 Meta Pixel을 추가한 페리 페이지: 이제 Facebook 파일만 남아 있습니다.
Legacy JavaScript는 어떻게 해결할까요?
직접 제어할 수 있는 가장 큰 파일부터 시작하고, 그다음 모든 페이지에서 구형 코드를 로드하는 플러그인이나 앱을 처리하세요.
WordPress
먼저 WordPress와 플러그인을 업데이트하세요. 최신 버전은 최신 브라우저용으로 빌드되었을 수 있습니다. 그런 다음 목록에 있는 각 파일에 대해 다음과 같이 조치하세요:
- 모든 페이지에 필요하지 않은 플러그인: 폼 플러그인의 날짜 선택기나 결제 게이트웨이 스크립트는 해당 기능이 쓰이는 페이지에만 있어야 합니다. Asset CleanUp(메뉴에서 "Asset CleanUp" -> "CSS & JS Manager")이나 Perfmatters의 Script Manager를 사용해 다른 모든 페이지에서 언로드하세요.
- 대체할 수 있는 플러그인: MonsterInsights 같은 분석 플러그인이 자체 스크립트를 모든 페이지에서 로드한다면, Site Kit by Google처럼 Google 태그만 추가하는 플러그인으로 바꾸세요.
wp-polyfill: Query Monitor 플러그인을 사용하면 여기에 의존하는 스크립트 목록을 볼 수 있습니다. 원인이 되는 플러그인을 찾아 문의 페이지의 Contact Form 7 reCAPTCHA처럼 실제 필요한 페이지에만 로드하세요. 최적화 도구에서wp-polyfill자체를 언로드하거나 코드에서 등록 해제(deregister)하면 안 됩니다. WordPress가 이 폴리필을 필요로 하는 모든 스크립트를 경고 없이 제외해 버리며, WooCommerce 쇼핑몰에서는 미니 장바구니, 장바구니, 결제 페이지 스크립트가 모두 여기에 해당합니다.
WP Rocket의 "Delay JavaScript execution" 기능을 쓰면 경고는 사라지지만, 방문자가 화면을 처음 탭하거나 스크롤할 때 동일한 코드를 다운로드하고 실행합니다.
Shopify
목록에 있는 파일은 앱, 테마에 붙여 넣은 태그, 혹은 커스텀 테마 자체 스크립트에서 비롯됩니다. 앱을 업데이트하거나 벤더에 최신 빌드를 요청하고, 더 이상 쓰지 않는 앱은 제거하세요. 커스텀 테마라면 개발자에게 빌드 설정을 전달해 수정하도록 요청하세요.
Next.js
Next.js는 기본적으로 자체 코드를 최신 브라우저용으로 빌드하며, package.json에 browserslist가 설정되어 있다면 그에 맞춰 빌드합니다. Next.js가 자체적으로 추가하는 폴리필을 제거하는 설정은 없습니다. 해당 항목은 그대로 두세요.
자체 빌드
빌드 도구에 지원할 브라우저를 지정하고 폴리필 추가를 중단하세요. Baseline Widely available은 모든 주요 브라우저가 최소 30개월 이상 지원해 온 기능 집합입니다. 전 세계 방문자의 약 0.2%만이 클래스나 async 함수를 실행하지 못하는 브라우저를 사용합니다. 설정을 변경하기 전에 자체 분석 데이터를 확인하여 iOS 15나 16에 머물러 있는 구형 iPhone 비중을 점검하세요. package.json에 다음과 같이 설정합니다:
"browserslist": [
"baseline widely available"
]
이 설정에는 browserslist 4.26 이상이 필요합니다. Babel 7을 사용 중이라면 @babel/preset-env에서 useBuiltIns, corejs, targets를 제거하고, 엔트리 파일에 import "core-js/stable" 줄이 있다면 삭제하세요:
// babel.config.js
module.exports = {
presets: ['@babel/preset-env']
};
targets가 없으면 Babel은 package.json의 browserslist를 읽습니다. 그러면 해당 브라우저에 없는 문법만 다시 작성하고 폴리필은 일절 추가하지 않습니다. Babel 8에서는 useBuiltIns와 corejs가 제거되었으며, Vite, esbuild, webpack 자체는 폴리필을 추가하지 않습니다. webpack 빌드에서 들어오는 폴리필은 babel-loader에서 비롯되므로 Babel 설정을 수정하면 함께 해결됩니다. Vite 역시 기본적으로 Baseline Widely available을 타깃으로 빌드합니다.
다시 빌드한 후에도 남아 있는 줄은 자체적으로 구형 빌드를 포함하고 있는 node_modules 패키지에서 나온 것입니다. 해당 패키지를 업데이트하거나 교체하세요.
그런 다음 이전과 동일한 방식으로 Lighthouse를 다시 실행하세요. "No legacy JavaScript found"로 표시되거나, 직접 빌드하지 않은 파일만 목록에 남게 됩니다.
페이지에서 전혀 사용하지 않는 스크립트는 다른 진단 항목인 Reduce unused JavaScript에 해당합니다.
보고서의 Legacy JavaScript를 그대로 두어도 되는 경우는 언제일까요?
목록에 표시된 항목이 Next.js 자체 폴리필이거나, 꼭 필요하지만 대체할 수 없는 벤더 태그이면서 경고가 주황색이라면 그대로 두어도 됩니다. 하지만 수십 KiB에 달하는 자체 번들이거나 경고가 빨간색인 경우에는 반드시 해결해야 합니다. 빨간색은 파일이 LCP 요소와 동시에 다운로드되고 있다는 뜻이며, 파일 크기를 줄여야 LCP 요소가 더 빨리 표시되기 때문입니다. 크기를 줄일 수 없는 벤더 태그라면 LCP 요소가 로드된 이후에 실행되도록 시점을 늦추는 방법이 있습니다: 스크립트 로드 시점을 늦추는 방법.
벤더 태그 10개와 플러그인 20개가 설치된 사이트라면 풀어야 할 문제가 다릅니다. 각 페이지에 어떤 스크립트가 정말로 필요한지부터 가려내야 합니다. power hour 컨설팅에서는 실제 사이트 보고서를 함께 열어보고, 목록에 있는 스크립트 중 어떤 것을 어느 페이지에 남겨둘지 명확히 정리해 드립니다.

더 빠른 사이트가 필요하신가요?
저는 Arjen입니다. 17년 동안 느린 사이트를 고쳐 왔습니다. 직접 해결하기 어려운 문제가 있다면 URL을 보내 주세요. 편하게 이야기 나눠요.
URL 보내기
수정했는데 왜 효과가 없을까요?
때로는 CDN이 아직 이전 HTML을 제공하거나, 수정이 데스크톱 템플릿에만 들어가고 모바일은 다른 템플릿을 쓰는 경우가 있습니다. URL과 문제를 보내 주시면 가능한 시간대를 몇 가지 회신해 드립니다. 먼저 field data를 살펴보고, 사이트를 1시간 함께 본 뒤, 하루 안에 정리 노트를 서면으로 보내 드립니다. €350 (부가세 별도).
URL 보내기수정을 구현할 개발자가 없으신가요? 사이트 복사본에서 제가 직접 작업합니다.