패턴 일치

일치 패턴은 다음과 같은 구조의 URL로, URL 그룹을 지정하는 데 사용됩니다.

<scheme>://<host>/<path>

scheme: 다음 중 하나여야 하며 나머지 패턴과는 이중 슬래시 (//)를 사용하여 구분해야 합니다.

  • http
  • https
  • http 또는 https와만 일치하는 와일드 카드 *
  • file

콘텐츠 스크립트를 about: 및 data:와 같이 지원되지 않는 스키마에 삽입하는 방법에 관한 자세한 내용은 관련 프레임에 삽입을 참고하세요.

host: 호스트 이름 (www.example.com). 하위 도메인 (*.example.com)과 일치시키기 위해 호스트 이름 앞에 *을 붙이거나 와일드 카드 *만 사용할 수 있습니다. - 호스트 패턴에 와일드 카드를 사용하는 경우 와일드 카드가 첫 번째 문자이거나 유일한 문자여야 하며 그 뒤에 마침표 (.) 또는 슬래시 (/)가 와야 합니다.

path: URL 경로 (/example)입니다. 호스트 권한의 경우 경로는 필수이지만 무시됩니다. 와일드 카드 (/*)는 관례에 따라 사용해야 합니다.

확장 프로그램은 다음을 비롯한 다양한 사용 사례에서 일치 패턴을 사용합니다.

특수한 케이스

"<all_urls>"
유효한 패턴에 나열된 패턴을 포함하여 허용된 스키마로 시작하는 모든 URL과 일치합니다. 모든 호스트에 영향을 미치므로 이를 사용하는 확장 프로그램의 Chrome 웹 스토어 검토에 시간이 더 오래 걸릴 수 있습니다.
"file:///"
확장 프로그램이 로컬 파일에서 실행되도록 허용합니다. 이 패턴을 사용하려면 사용자가 직접 액세스 권한을 부여해야 합니다. 이 경우에는 슬래시가 2개가 아닌 3개 필요합니다.
localhost URL 및 IP 주소
개발 중에 로컬호스트 포트를 일치시키려면 http://localhost/*를 사용하세요. IP 주소의 경우 http://127.0.0.1/*와 같이 경로에 주소와 와일드 카드를 지정합니다. http://*:*/*를 사용하여 localhost, IP 주소, 포트를 일치시킬 수도 있습니다.
최상위 도메인 일치 패턴
Chrome은 최상위 도메인 (TLD)의 일치 패턴을 지원하지 않습니다. http://google.es/* 및 http://google.fr/*와 같이 개별 TLD 내에서 일치 패턴을 지정합니다.

패턴 예

https://*/* 또는 https://*/
https 스키마를 사용하는 모든 URL과 일치합니다.
https://*/foo*
모든 호스트에서 https 스키마를 사용하며 foo로 시작하는 경로를 가진 모든 URL과 일치합니다. 일치의 예로는 https://example.com/foo/bar.html 및 https://www.google.com/foo가 있습니다.
https://*.google.com/foo*bar
google.com 호스트에서 https 스키마를 사용하고 경로가 foo로 시작하며 bar로 끝나는 모든 URL과 일치합니다. 일치의 예로는 https://www.google.com/foo/baz/bar 및 https://docs.google.com/foobar가 있습니다.
file:///foo*
경로가 foo로 시작하는 모든 로컬 파일과 일치합니다. 일치의 예로는 file:///foo/bar.html 및 file:///foo가 있습니다.
http://127.0.0.1/* 또는 http://127.0.0.1/
http 스키마를 사용하고 127.0.0.1 호스트에 있는 모든 URL과 일치합니다. 일치의 예로는 http://127.0.0.1/ 및 http://127.0.0.1/foo/bar.html가 있습니다.
http://localhost/*
모든 localhost 포트와 일치합니다.
*://mail.google.com/ 또는 *://mail.google.com/*
http://mail.google.com 또는 https://mail.google.com로 시작하는 모든 URL과 일치합니다.