externally_connectable

externally_connectable 資訊清單屬性會宣告可執行的擴充功能、應用程式和網頁 透過 runtime.connect 和 runtime.sendMessage 連線至您的應用程式。

如需訊息傳遞的教學課程，請參閱「跨擴充功能和應用程式訊息功能」和「傳送訊息」一文 網頁。

不使用 external_connectable 連線

如未在應用程式資訊清單中宣告 externally_connectable，所有擴充功能和應用程式皆可 卻無法連線網頁。因此，將資訊清單更新為使用 externally_connectable；如未指定 "ids": ["*"]，其他擴充功能和應用程式就會 也無法存取您的應用程式這可能是非預期的結果，因此請留意。

manifest.json 範例

{
  "name": "My externally connectable app",
  "externally_connectable": {
    // Extension and app IDs. If this field is not specified, no
    // extensions or apps can connect.
    "ids": [
      "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
      ...
      // Alternatively, to match all extensions and apps, specify only
      // "*".
      "*"
    ],
    // Match patterns for web pages. Does not affect content scripts.
    // If this field is not specified, no webpages can connect.
    "matches": [
      "https://*.google.com/*",
      "*://*.chromium.org/*",
      ...
    ],
    // Indicates that the extension would like to make use of the TLS
    // channel ID of the web page connecting to it. The web page must
    // also opt to send the TLS channel ID to the extension via setting
    // includeTlsChannelId to true in runtime.connect's connectInfo
    // or runtime.sendMessage's options.
    "accepts_tls_channel_id": false
  },
  ...
}

參考資料

external_connectable 資訊清單鍵可具有下列屬性：

  • ids (字串陣列) - 選用

    允許連結的擴充功能或應用程式的 ID。如果留空或未指定，則否 擴充功能或應用程式可以連結

    使用萬用字元 "*" 將允許所有擴充功能和應用程式連線。

  • matches (字串陣列) - 選用

    允許連結的網頁網址模式。這不會影響內容 指令碼如果留空或未指定，則無法連結任何網頁。

    模式不得包含萬用字元網域或 (有效) 頂層網域的子網域。 *://google.com/* 和 https://*.chromium.org/* 有效，但 <all_urls>、https://*/* *://*.com/*，甚至 https://*.appspot.com/* 都不是。

  • accepts_tls_channel_id (布林值) - 選用

    如果 true，系統會設定透過 runtime.connect 或 runtime.sendMessage 傳送的郵件 runtime.MessageSender.tlsChannelId。如果是 false， 無論如何，runtime.MessageSender.tlsChannelId 一律不會設定。