패턴 일치

호스트 권한콘텐츠 스크립트 일치는 일치 패턴으로 정의된 URL 집합에 기반합니다. 일치 패턴은 허용되는 스키마 (http, https, file 또는 ftp)로 시작하고 '*' 문자를 포함할 수 있는 URL입니다. 특수 패턴 <all_urls>는 허용된 스키마로 시작하는 모든 URL과 일치합니다. 각 일치 패턴은 다음 3가지 부분으로 구성됩니다.

  • 스키마: 예를 들면 http 또는 file 또는 *

    참고: file URL에 대한 액세스 권한은 자동으로 부여되지 않습니다. 사용자는 확장 프로그램 관리 페이지로 이동하여 요청하는 각 확장 프로그램에 대해 file 액세스를 선택해야 합니다.
  • 호스트: 예: www.google.com, *.google.com, *. 스키마가 file인 경우 호스트 부분이 없습니다.

  • 경로: 예를 들면 /*, /foo*, /foo/bar입니다. 경로는 호스트 권한에 있어야 하지만 항상 /*로 취급됩니다.

기본 구문은 다음과 같습니다.

&lt;url-pattern&gt; := &lt;scheme&gt;://&lt;host&gt;&lt;path&gt;
&lt;scheme&gt; := '*' | 'http' | 'https' | 'file' | 'ftp' | 'urn'
&lt;host&gt; := '*' | '*.' &lt;any char except '/' and '*'&gt;+
&lt;path&gt; := '/' &lt;any chars&gt;

'*'의 의미는 스키마, 호스트 또는 경로 중 어느 부분에 있는지에 따라 다릅니다. 스키마*이면 http 또는 https와 일치하며 file, ftp 또는 urn와는 일치하지 않습니다. 호스트*이면 모든 호스트와 일치합니다. 호스트*._hostname_이면 지정된 호스트 또는 그 하위 도메인과 일치합니다. 경로 섹션에서 각 '*'는 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*barhttps 스키마를 사용하고, google.com 호스트에 있으며 (예: www.google.com, docs.google.com 또는 google.com), 경로가 /foo로 시작하고 bar로 끝나는 모든 URL과 일치합니다.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경로 없음
http://*foo/bar호스트의 '*' 뒤에는 '.' 또는 '/'만 올 수 있습니다.
http://foo.*.bar/baz 호스트에 '*'가 있는 경우 첫 번째 문자로만 사용해야 합니다.
http:/bar스키마 구분 기호가 누락되었습니다 ('/' 대신 '//' 사용).
foo://*잘못된 스키마

일부 스키마는 일부 컨텍스트에서 지원되지 않습니다.