요청을 일치시키는 방법

세 가지 일치 방식 중 선택하기

브라우저 규칙 형식 두 가지와 더 쉬운 RequestOrbit 형식 한 가지가 있습니다. 대부분은 첫 번째 방식이면 충분합니다.

새 규칙은 URL 필터로 시작합니다. 입력이 정규식으로 명확하게 보이면 전환을 제안하지만, 모드를 자동으로 바꾸지는 않습니다.

• URL 필터(권장): 도메인, 고정 URL, 경로에 알맞은 브라우저 기본 문법입니다. $1 값은 만들 수 없습니다.
• 간단한 와일드카드: RequestOrbit가 각 *를 캡처 값으로 바꿉니다. 원래 URL의 일부를 간단히 보존하는 리디렉션에 알맞습니다.
• 정규식: 정확한 캡처, 선택지, 고급 조건에 사용하며 현재 브라우저가 지원 여부를 검사합니다.

||와 ^의 의미

URL 필터에서 ||는 도메인 이름부터 일치하며 하위 도메인도 포함합니다. 도메인 뒤의 ^는 구분 문자나 URL 끝을 요구하므로 example.com이 example.company와 잘못 일치하지 않습니다. | 하나는 시작이나 끝을 고정하고, *는 임의 개수의 문자와 일치합니다.

이는 WebExtension 사이트 권한의 일치 패턴이 아니라 declarativeNetRequest URL 필터 문법입니다. 필요한 권한 패턴은 RequestOrbit가 자동으로 만듭니다.

            ||example.com^
|https://example.com/app.js|
https://example.com/assets/*
          

캡처와 $1부터 $9

간단한 와일드카드에서는 첫 번째 *가 $1, 두 번째가 $2가 됩니다. 정규식에서는 ^와 $가 URL의 시작과 끝, \.이 마침표 자체, .*가 임의의 문자열, (...)가 캡처 그룹을 뜻합니다.

$1부터 $9는 리디렉션 대상에서만 씁니다. URL 필터의 *는 문자열과 일치하지만 캡처하지 않습니다.

마지막으로 리소스 유형, 요청 메서드, 요청 출처 도메인으로 범위를 더 좁힐 수 있습니다. 유형이나 메서드를 비워 두면 제한하지 않습니다.

            Simple wildcard
Match         https://api.example.com/v1/*
Request       https://api.example.com/v1/users/42
$1 = users/42
Destination   http://localhost:3000/v1/$1

Regular expression
Match         ^https://api\.example\.com/v1/(users|projects)/([^?]+)$
Request       https://api.example.com/v1/projects/alpha
$1 = projects, $2 = alpha
Destination   https://api.example.com/v2/$1/$2