패턴 일치

일치 패턴은 다음과 같은 구조의 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개가 필요합니다.
로컬 호스트 URL 및 IP 주소
개발 중에 localhost 포트를 일치시키려면 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 스키마를 사용하는 모든 URL의 경로를 foo로 시작하고 bar로 끝납니다. 일치하는 항목의 예로는 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과 일치합니다.