"externally_connectable"
매니페스트 속성은
runtime.connect()
및 runtime.sendMessage()
를 사용하여 확장 프로그램에 연결하세요.
메시지 전달에 관한 가이드는 교차 확장 메시지 및 메시지 보내기를 참고하세요. 웹페이지를 확인하세요.
external_connectable 없이 연결
externally_connectable
키가 확장 프로그램의 매니페스트에 선언되지 않은 경우 모든 확장 프로그램을 연결할 수 있지만 웹페이지는 연결할 수 없습니다. 따라서 매니페스트를 업데이트하여
externally_connectable
, "ids": ["*"]
를 지정하지 않으면 다른 확장 프로그램이
확장 프로그램에 연결할 수 없게 됩니다. 의도하지 않은 결과가 발생할 수 있으므로
생각해야 합니다.
매니페스트
{
"name": "My externally connectable extension",
"externally_connectable": {
"ids": [
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
...
],
// If this field is not specified, no web pages can connect.
"matches": [
"https://*.google.com/*",
"*://*.chromium.org/*",
...
],
"accepts_tls_channel_id": false
},
...
}
참조
"externally_connectable"
매니페스트 키에는 다음과 같은 선택적 속성이 포함됩니다.
"ids"
- 연결이 허용된 확장 프로그램의 ID입니다. 비워 두거나 지정하지 않으면 확장 프로그램이나 앱을 연결할 수 없습니다. 와일드 카드
"*"
를 사용하면 모든 확장 프로그램 및 앱의 연결이 허용됩니다. "matches"
- 연결이 허용된 웹페이지의 URL 패턴입니다. 비워 두거나 지정하지 않으면 웹페이지를 연결할 수 없습니다. 패턴에는 와일드 카드 도메인이나 (유효한) 최상위 도메인의 하위 도메인이 포함될 수 없습니다. 예를 들면 다음과 같습니다.
✅ 유효한 URL | ❌ 잘못된 URL |
---|---|
*://example.com/ |
*://example.com/one/ |
http://*.example.org/* |
<all_urls> |
https://example.com/* |
http://*/* |
"accepts_tls_channel_id"
- 확장 프로그램이 연결된 웹페이지의 TLS 채널 ID를 사용하도록 설정합니다. 또한 웹페이지는 다음을 설정하여 TLS 채널 ID를 확장 프로그램에 전송하도록 선택해야 합니다.
런타임.연결의 connectInfo 또는runtime.sendMessage의 옵션에서
includeTlsChannelId
을true
로 설정합니다.false
로 설정된 경우 runtime.MessageSender.tlsChannelId는 어떠한 경우에도 설정되지 않습니다.
이는 콘텐츠 스크립트에는 영향을 미치지 않습니다.