호스트 권한 및 콘텐츠 스크립트 일치는 일치 패턴으로 정의된 URL 집합을 기반으로 합니다. 일치 패턴은 기본적으로 허용되는 스키마 (http
, https
, file
또는 ftp
)로 시작하고 '*
' 문자를 포함할 수 있는 URL입니다. 특수 패턴 <all_urls>
는 허용된 스키마로 시작하는 모든 URL과 일치합니다. 각 일치 패턴은 다음 세 부분으로 구성됩니다.
스키마 - 예:
http
,file
또는*
참고:file
URL에 대한 액세스는 자동으로 이루어지지 않습니다. 사용자는 확장 프로그램 관리 페이지를 방문하여 요청하는 각 확장 프로그램에 대해file
액세스 권한을 선택해야 합니다.host - 예:
www.google.com
또는*.google.com
또는*
. 스키마가file
이면 호스트 부분이 없음path - 예:
/*
,/foo*
,/foo/bar
경로는 호스트 권한에 있어야 하지만 항상/*
로 처리됩니다.
기본 구문은 다음과 같습니다.
<url-pattern> := <scheme>://<host><path>
<scheme> := '*' | 'http' | 'https' | 'file' | 'ftp' | 'urn'
<host> := '*' | '*.' <any char except '/' and '*'>+
<path> := '/' <any chars>
'*
'의 의미는 스키마, 호스트 또는 경로 부분 중 어디에 있는지에 따라 다릅니다. 스키마가 *
이면 http
또는 https
와 일치하고 file
, ftp
또는 urn
가 아닙니다. 호스트가 *
이면 모든 호스트와 일치합니다. 호스트가 *._hostname_
이면 지정된 호스트 또는 그 하위 도메인과 일치합니다. path 섹션에서 각 '*
'는 0개 이상의 문자와 일치합니다. 다음 표에는 몇 가지 유효한 패턴이 나와 있습니다.
패턴 | 기능 | 일치하는 URL의 예 |
---|---|---|
http://*/* | http 스키마를 사용하는 모든 URL과 일치합니다. | http://www.google.com/ http://example.org/foo/bar.html |
http://*/foo* | 경로가 /foo 로 시작하는 모든 호스트에서 http 스키마를 사용하는 모든 URL과 일치합니다. | http://example.com/foo/bar.html http://www.google.com/foo |
https://*.google.com/foo*bar | https 스키마를 사용하고 google.com 호스트 (예: www.google.com, docs.google.com 또는 google.com)에 있는 모든 URL과 일치합니다. 단, 경로가 /foo 로 시작하고 bar 로 끝납니다. | https://www.google.com/foo/baz/bar https://docs.google.com/foobar |
http://example.org/foo/bar.html | 지정된 URL과 일치 | http://example.org/foo/bar.html |
file:///foo* | 경로가 /foo 로 시작하는 로컬 파일과 일치합니다. | file:///foo/bar.html file:///foo |
http://127.0.0.1/* | http 스키마를 사용하고 127.0.0.1 호스트에 있는 모든 URL과 일치합니다. | http://127.0.0.1/ http://127.0.0.1/foo/bar.html |
*://mail.google.com/* | http://mail.google.com 또는 https://mail.google.com 로 시작하는 모든 URL과 일치합니다. | http://mail.google.com/foo/baz/bar https://mail.google.com/foobar |
urn:* | urn: 로 시작하는 모든 URL과 일치합니다. | urn:uuid:54723bea-c94e-480e-80c8-a69846c3f582 urn:uuid:cfa40aff-07df-45b2-9f95-e023bcf4a6da |
<all_urls> | 허용되는 스키마를 사용하는 모든 URL과 일치합니다. 허용되는 스키마의 목록은 이 섹션의 시작 부분을 참조하세요. | http://example.org/foo/bar.html file:///bar/baz.html |
다음은 잘못된 패턴 일치의 몇 가지 예입니다.
잘못된 패턴 | 문제가 되는 이유 |
---|---|
http://www.google.com | path 없음 |
http://*foo/bar | 호스트의 '*' 다음에는 '.' 또는 '/'만 사용할 수 있습니다. |
http://foo.*.bar/baz | host에 '*'가 있으면 첫 번째 문자여야 합니다. |
http:/bar | 스키마 구분자 누락 ('/'은 '//'여야 함) |
foo://* | 잘못된 스키마 |
일부 스키마는 모든 컨텍스트에서 지원되지 않습니다.