AdGuard 블로그 AdGuard 브라우저 확장 프로그램 v5.2: User Scripts API로 마이그레이션

AdGuard 브라우저 확장 프로그램 v5.2: User Scripts API로 마이그레이션

2025년 10월 17일 5분 소요

AdGuard 브라우저 확장 프로그램 v5.2가 출시되었습니다. 이번 버전에서는 내부 개선 사항, 시각적 및 접근성 업데이트 등 다양한 개선 사항이 적용되어 확장 프로그램의 성능과 사용자 맞춤형 기능을 강화했습니다. 이번 버전의 주요 기능을 살펴보겠습니다.

사용자 정의 필터

사용자 정의 필터 *border

이제 MV3 확장 프로그램에서 사용자 정의 필터를 직접 추가할 수 있습니다! API 제한으로 인해 MV3로 마이그레이션한 후 잠시 중단되었던 이 기능이 마침내 돌아와 여러분이 사용할 준비가 되었습니다.

기본적으로 포함되지 않았지만 사용하고 싶은 규칙이 있다면, 확장 프로그램에 바로 추가하기만 하면 됩니다. 이는 Chrome의 새로운 유저스크립트 API로 구동되며, 이는 사용자 정의 필터가 내부적으로 약간 다르게 작동함을 의미합니다.

User Scripts API는 확장 프로그램이 웹페이지에서 사용자 지정 JavaScript 스크립트를 실행할 수 있도록 하는 브라우저에서 제공하는 일련의 기능입니다. 이 기능은 웹사이트 자체에서 원래 제공하지 않는 방식으로 웹사이트를 수정하거나 개선하는 데 자주 사용됩니다.

User Scripts API로 마이그레이션에 대한 자세한 내용은 지식 창고를 참조하세요.

사용자 정의 규칙 추가 방법:

설정 → 필터로 이동합니다.
사용자 정의 섹션에서 유저스크립트 허용을 활성화하라는 경고 메시지가 표시됩니다. 링크를 클릭하여 브라우저 확장 프로그램 설정을 엽니다.

설정 *border

유저스크립트 허용 옵션을 토글하여 활성화합니다.

사용자 스크립트 허용 *border

필터 탭으로 돌아가서 사용자 정의를 열고, 오른쪽 상단 모서리의 스위치를 사용하여 활성화합니다.
사용자 정의 필터 추가를 클릭합니다.

유저스크립트 API를 사용하면 이제 내장된 확장 프로그램 필터에 포함되지 않은 스크립트를 사용자 규칙에도 적용할 수 있습니다. 방법은 다음과 같습니다:

설정 → 사용자 규칙으로 이동합니다.
유저스크립트 허용을 활성화하라는 경고 메시지가 표시됩니다. 링크를 클릭하여 브라우저의 확장 프로그램 설정을 엽니다.
유저스크립트 허용 옵션을 토글하여 활성화합니다.
사용자 규칙 탭으로 돌아갑니다.
가져오기를 클릭하거나 직접 규칙을 작성한 후 저장을 클릭합니다.

업데이트 확인

MV3에서는 필터가 확장 프로그램 자체와 함께 업데이트됩니다. 지금까지는 새로운 필터를 받기까지 오랜 시간이 걸렸는데, 그 이유는 모든 업데이트가 Chrome 웹스토어 검토 과정을 거쳐야 했기 때문입니다. 최근에 Chrome이 검토를 건너뛸 수 있는 옵션을 도입하면서 이 과정이 크게 빨라졌습니다.

저희는 빌드 프로세스를 개선하여 이제 업데이트가 이 빠른 절차를 통과할 가능성이 높아졌습니다. 즉, 최신 필터를 훨씬 더 빨리 받을 수 있습니다. 또한 업데이트 확인 버튼을 추가했습니다. 기다리고 싶지 않다면 이제 한 번의 클릭으로 직접 업데이트 확인을 실행할 수 있습니다.

업데이트 확인 *border

차단 페이지

MV2 확장 프로그램의 차단 페이지를 재설계하고, MV3에 추가했습니다. 이제 $document 수정자가 포함된 차단 규칙이 실행되면 더 명확하고 자세한 경고 페이지가 표시됩니다. 또한, 잠재적으로 위험한 웹사이트를 방문하려고 할 경우, MV2 확장 프로그램이 이해하기 쉽고 대응하기 쉬운 재설계된 안전 브라우징 경고를 표시합니다.

차단 페이지 *border