"externally_connectable"
manifest özelliği, hangi uzantıların ve web sayfalarının runtime.connect()
ve runtime.sendMessage()
kullanarak uzantınıza bağlanabileceğini tanımlar.
Mesaj iletmeyle ilgili bir eğitim için uzantılar arası mesajlaşma ve web sayfalarından mesaj gönderme bölümlerine bakın.
external_connectable olmadan bağlan
externally_connectable
anahtarı, uzantınızın manifest dosyasında belirtilmemişse tüm uzantılar bağlanabilir ancak hiçbir web sayfası bağlanamaz. Sonuç olarak, manifestinizi externally_connectable
kullanacak şekilde güncellerken "ids": ["*"]
belirtilmezse diğer uzantıların uzantınıza bağlanma özelliği kaybolur. Bu istenmeyen bir sonuç olabileceğinden bunu aklınızda bulundurun.
Manifest
{
"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
},
...
}
Referans
"externally_connectable"
manifest anahtarı, aşağıdaki isteğe bağlı özellikleri içerir:
"ids"
- Bağlanmasına izin verilen uzantıların kimlikleri. Boş bırakılırsa veya belirtilmemişse hiçbir uzantı veya uygulama bağlanamaz.
"*"
joker karakteri, tüm uzantı ve uygulamaların bağlanmasına izin verir. "matches"
- Bağlanmasına izin verilen web sayfalarının URL kalıpları. Boş bırakılırsa veya belirtilmemişse hiçbir web sayfası bağlanamaz. Kalıplar, joker karakterli alanları veya (etkili) üst düzey alanların alt alanlarını içeremez. Örneğin:
✅ Geçerli URL'ler | ❌ Geçersiz URL'ler |
---|---|
*://example.com/ |
*://example.com/one/ |
http://*.example.org/* |
<all_urls> |
https://example.com/* |
http://*/* |
"accepts_tls_channel_id"
- Uzantıyı, kendisine bağlanan web sayfasının TLS kanal kimliğini kullanacak şekilde etkinleştirir. Web sayfası,ucus.connect'in connectInfo veyaworkspace.sendMessage seçeneklerinde
includeTlsChannelId
'yitrue
olarak ayarlayarak uzantıya TLS kanal kimliğini göndermeyi de tercih etmelidir.false
olarak ayarlanırsa runtime.MessageSender.tlsChannelId hiçbir koşulda ayarlanmaz.
Bu, içerik komut dosyalarını etkilemez.