webext-schema 5.2.8 → 5.2.10

package/schemas/mail/mailext.json

@@ -1704,6 +1704,24 @@
             "os_update",
             "periodic"
           ]
+        },
+        {
+          "id": "OnPerformanceWarningCategory",
+          "type": "string",
+          "enum": [
+            "content_script"
+          ],
+          "description": "The performance warning event category, e.g. 'content_script'."
+        },
+        {
+          "id": "OnPerformanceWarningSeverity",
+          "type": "string",
+          "enum": [
+            "low",
+            "medium",
+            "high"
+          ],
+          "description": "The performance warning event severity. Will be 'high' for serious and user-visible issues."
         }
       ],
       "properties": {
@@ -2281,6 +2299,36 @@
               "description": "The reason that the event is being dispatched."
             }
           ]
+        },
+        {
+          "name": "onPerformanceWarning",
+          "type": "function",
+          "description": "Fired when a runtime performance issue is detected with the extension. Observe this event to be proactively notified of runtime performance problems with the extension.",
+          "parameters": [
+            {
+              "type": "object",
+              "name": "details",
+              "properties": {
+                "category": {
+                  "$ref": "OnPerformanceWarningCategory",
+                  "description": "The performance warning event category, e.g. 'content_script'."
+                },
+                "severity": {
+                  "$ref": "OnPerformanceWarningSeverity",
+                  "description": "The performance warning event severity, e.g. 'high'."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "description": "The $(ref:tabs.Tab) that the performance warning relates to, if any."
+                },
+                "description": {
+                  "type": "string",
+                  "description": "An explanation of what the warning means, and hopefully how to address it."
+                }
+              }
+            }
+          ]
         }
       ]
     }
@@ -5760,51 +5808,6 @@
           "type": "object",
           "description": "Used by various functions to represent the state of a message being composed. Note that functions using this type may have a partial implementation.",
           "properties": {
-            "identityId": {
-              "type": "string",
-              "description": "The ID of an identity from the :doc:`accounts`. The settings from the identity will be used in the composed message. If ``replyTo`` is also specified, the ``replyTo`` property of the identity is overridden. The permission <permission>accountsRead</permission> is required to include the ``identityId``.",
-              "optional": true
-            },
-            "from": {
-              "$ref": "ComposeRecipient",
-              "description": "*Caution*: Setting a value for ``from`` does not change the used identity, it overrides the FROM header. Many email servers do not accept emails where the FROM header does not match the sender identity. Must be set to exactly one valid email address.",
-              "optional": true
-            },
-            "to": {
-              "$ref": "ComposeRecipientList",
-              "optional": true
-            },
-            "cc": {
-              "$ref": "ComposeRecipientList",
-              "optional": true
-            },
-            "bcc": {
-              "$ref": "ComposeRecipientList",
-              "optional": true
-            },
-            "overrideDefaultFcc": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Indicates whether the default fcc setting (defined by the used identity) is being overridden for this message. Setting <value>false</value> will clear the override. Setting <value>true</value> will throw an <em>ExtensionError</em>, if ``overrideDefaultFccFolder`` is not set as well."
-            },
-            "overrideDefaultFccFolder": {
-              "choices": [
-                {
-                  "$ref": "folders.MailFolderId"
-                },
-                {
-                  "$ref": "folders.MailFolder"
-                },
-                {
-                  "type": "string",
-                  "enum": [
-                    ""
-                  ]
-                }
-              ],
-              "optional": true,
-              "description": " This value overrides the default fcc setting (defined by the used identity) for this message only. Either a :ref:`folders.MailFolder` specifying the folder for the copy of the sent message, or an empty string to not save a copy at all."
-            },
             "additionalFccFolder": {
               "choices": [
                 {
@@ -5823,58 +5826,80 @@
               "description": "An additional fcc folder which can be selected while composing the message, an empty string if not used.",
               "optional": true
             },
-            "replyTo": {
-              "$ref": "ComposeRecipientList",
+            "attachVCard": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Whether or not the vCard of the used identity will be attached to the message during send. **Note:** If the value has not been modified, selecting a different identity will load the default value of the new identity."
+            },
+            "attachments": {
+              "type": "array",
+              "items": {
+                "choices": [
+                  {
+                    "$ref": "FileAttachment"
+                  },
+                  {
+                    "$ref": "ComposeAttachment"
+                  }
+                ]
+              },
+              "description": "Only used in the begin* functions. Attachments to add to the message.",
               "optional": true
             },
-            "followupTo": {
+            "bcc": {
               "$ref": "ComposeRecipientList",
               "optional": true
             },
-            "newsgroups": {
-              "description": "A single newsgroup name or an array of newsgroup names.",
-              "choices": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                }
-              ],
+            "body": {
+              "type": "string",
+              "description": "The HTML content of the message.",
               "optional": true
             },
-            "relatedMessageId": {
-              "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <value>null</value> in all other cases or if the original message was opened from file.",
-              "$ref": "messages.MessageId",
+            "cc": {
+              "$ref": "ComposeRecipientList",
               "optional": true
             },
-            "subject": {
-              "type": "string",
+            "customHeaders": {
+              "type": "array",
+              "items": {
+                "$ref": "CustomHeader"
+              },
+              "description": "Array of custom headers. Headers will be returned in <em>Http-Header-Case</em> (a.k.a. <em>Train-Case</em>). Set an empty array to clear all custom headers.",
               "optional": true
             },
-            "type": {
+            "deliveryFormat": {
               "type": "string",
-              "description": "Read-only. The type of the message being composed, depending on how the compose window was opened by the user.",
               "enum": [
-                "draft",
-                "new",
-                "redirect",
-                "reply",
-                "forward"
+                "auto",
+                "plaintext",
+                "html",
+                "both"
               ],
+              "description": "Defines the MIME format of the sent message (ignored on plain text messages). Defaults to <value>auto</value>, which will send html messages as plain text, if they do not include any formatting, and as <value>both</value> otherwise (a multipart/mixed message).",
               "optional": true
             },
-            "body": {
-              "type": "string",
-              "description": "The HTML content of the message.",
+            "deliveryStatusNotification": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Let the sender know when the recipient's server received the message. Not supported by all servers."
+            },
+            "followupTo": {
+              "$ref": "ComposeRecipientList",
               "optional": true
             },
-            "plainTextBody": {
+            "from": {
+              "$ref": "ComposeRecipient",
+              "description": "*Caution*: Setting a value for ``from`` does not change the used identity, it overrides the <value>From</value> header. Many email servers do not accept emails where the <value>From</value> header does not match the sender identity. Must be set to exactly one valid email address.",
+              "optional": true
+            },
+            "identityId": {
               "type": "string",
-              "description": "The plain text content of the message.",
+              "description": "The ID of an identity from the :doc:`accounts`. The settings from the identity will be used in the composed message. If ``replyTo`` is also specified, the ``replyTo`` property of the identity is overridden. The permission <permission>accountsRead</permission> is required to include the ``identityId``.",
+              "optional": true
+            },
+            "isModified": {
+              "type": "boolean",
+              "description": "Whether the composer is considered modified by the user. A modified composer asks for confirmation, when it is closed.",
               "optional": true
             },
             "isPlainText": {
@@ -5882,23 +5907,47 @@
               "description": "Whether the message is an HTML message or a plain text message.",
               "optional": true
             },
-            "deliveryFormat": {
-              "type": "string",
-              "enum": [
-                "auto",
-                "plaintext",
-                "html",
-                "both"
+            "newsgroups": {
+              "description": "A single newsgroup name or an array of newsgroup names.",
+              "choices": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
               ],
-              "description": "Defines the mime format of the sent message (ignored on plain text messages). Defaults to <value>auto</value>, which will send html messages as plain text, if they do not include any formatting, and as <value>both</value> otherwise (a multipart/mixed message).",
               "optional": true
             },
-            "customHeaders": {
-              "type": "array",
-              "items": {
-                "$ref": "CustomHeader"
-              },
-              "description": "Array of custom headers. Headers will be returned in <em>Http-Header-Case</em> (a.k.a. <em>Train-Case</em>). Set an empty array to clear all custom headers.",
+            "overrideDefaultFcc": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Indicates whether the default fcc setting (defined by the used identity) is being overridden for this message. Setting <value>false</value> will clear the override. Setting <value>true</value> will throw an <em>ExtensionError</em>, if ``overrideDefaultFccFolder`` is not set as well."
+            },
+            "overrideDefaultFccFolder": {
+              "choices": [
+                {
+                  "$ref": "folders.MailFolderId"
+                },
+                {
+                  "$ref": "folders.MailFolder"
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    ""
+                  ]
+                }
+              ],
+              "optional": true,
+              "description": " This value overrides the default fcc setting (defined by the used identity) for this message only. Either a :ref:`folders.MailFolder` specifying the folder for the copy of the sent message, or an empty string to not save a copy at all."
+            },
+            "plainTextBody": {
+              "type": "string",
+              "description": "The plain text content of the message.",
               "optional": true
             },
             "priority": {
@@ -5913,34 +5962,38 @@
               "description": "The priority of the message.",
               "optional": true
             },
+            "relatedMessageId": {
+              "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <value>null</value> in all other cases or if the original message was opened from file.",
+              "$ref": "messages.MessageId",
+              "optional": true
+            },
+            "replyTo": {
+              "$ref": "ComposeRecipientList",
+              "optional": true
+            },
             "returnReceipt": {
               "type": "boolean",
               "optional": true,
               "description": "Add the <em>Disposition-Notification-To</em> header to the message to requests the recipients email client to send a reply once the message has been received. Recipient server may strip the header and the recipient might ignore the request."
             },
-            "deliveryStatusNotification": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Let the sender know when the recipient's server received the message. Not supported by all servers."
+            "subject": {
+              "type": "string",
+              "optional": true
             },
-            "attachVCard": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Whether or not the vCard of the used identity will be attached to the message during send. **Note:** If the value has not been modified, selecting a different identity will load the default value of the new identity."
+            "to": {
+              "$ref": "ComposeRecipientList",
+              "optional": true
             },
-            "attachments": {
-              "type": "array",
-              "items": {
-                "choices": [
-                  {
-                    "$ref": "FileAttachment"
-                  },
-                  {
-                    "$ref": "ComposeAttachment"
-                  }
-                ]
-              },
-              "description": "Only used in the begin* functions. Attachments to add to the message.",
+            "type": {
+              "type": "string",
+              "description": "Read-only. The type of the message being composed, depending on how the compose window was opened by the user.",
+              "enum": [
+                "draft",
+                "new",
+                "redirect",
+                "reply",
+                "forward"
+              ],
               "optional": true
             }
           }
@@ -5992,8 +6045,7 @@
           "properties": {
             "name": {
               "type": "string",
-              "description": "Name of a custom header, must have a <value>X-</value> prefix.",
-              "pattern": "^X-.*$"
+              "description": "Name of a custom header, must be prefixed by <value>X-</value> (but not by <value>X-Mozilla-</value>) or be one of the explicitly allowed headers (<value>MSIP_Labels</value>)"
             },
             "value": {
               "type": "string"
@@ -6109,6 +6161,7 @@
                   "type": "string",
                   "description": "The used save mode.",
                   "enum": [
+                    "autoSave",
                     "draft",
                     "template"
                   ]
@@ -9767,7 +9820,7 @@
           }
         },
         {
-          "id": "SingleMenuIconPath",
+          "id": "MenuIconPath",
           "choices": [
             {
               "type": "string",
@@ -9775,27 +9828,20 @@
             },
             {
               "type": "string",
-              "pattern": "^(moz-extension|blob):.*$"
+              "pattern": "^(moz-extension|blob|http|https):.*$"
             }
           ],
-          "description": "The provided path may be a relative path to an icon file, an image <value>data:</value> URL, a <value>blob:</value> URL or a <value>moz-extension:<value> URL. The <value>data:</value> or <value>blob:</value> URLs can be retrieved as follows: <literalinclude>includes/DataBlobUrls.js<lang>JavaScript</lang></literalinclude>,"
+          "description": "The path for a menu icon may be a relative path to an icon file, a <value>moz-extension:</value> URL, an image <value>data:</value> URL, a <value>blob:</value> URL, or a remote <value>http(s):</value> URL."
         },
         {
-          "id": "MenuIconPath",
-          "choices": [
-            {
-              "$ref": "SingleMenuIconPath"
-            },
-            {
-              "type": "object",
-              "patternProperties": {
-                "^[1-9]\\d*$": {
-                  "$ref": "SingleMenuIconPath"
-                }
-              }
+          "id": "MenuIconDictionary",
+          "type": "object",
+          "patternProperties": {
+            "^[1-9]\\d*$": {
+              "$ref": "MenuIconPath"
             }
-          ],
-          "description": "Either a <em>string</em> to specify a single icon path to be used for all sizes, or a <em>dictionary object</em> to specify paths for multiple icons in different sizes, so the icon does not have to be scaled for a device with a different pixel density. Each entry is a <em>name-value</em> pair with <em>name</em> being a size and <em>value</em> being a path to the icon for the specified size. Example: <literalinclude>includes/IconPath.json<lang>JSON</lang></literalinclude>See the `MDN documentation about choosing icon sizes <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action#choosing_icon_sizes>`__ for more information on this. "
+          },
+          "description": "A <em>dictionary object</em> to specify paths for multiple icons in different sizes, so the best matching icon can be used, instead of scaling a standard icon to fit the pixel density of the user's display. Each entry is a <em>name-value</em> pair, with <em>name</em> being a size and <em>value</em> being a :ref:`menus.MenuIconPath`. Example: <literalinclude>includes/IconPath.json<lang>JSON</lang></literalinclude>See the `MDN documentation about choosing icon sizes <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/browser_action#choosing_icon_sizes>`__ for more information on this. "
         }
       ],
       "functions": [
@@ -9830,7 +9876,14 @@
                   "description": "The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension."
                 },
                 "icons": {
-                  "$ref": "MenuIconPath",
+                  "choices": [
+                    {
+                      "$ref": "MenuIconPath"
+                    },
+                    {
+                      "$ref": "MenuIconDictionary"
+                    }
+                  ],
                   "optional": true,
                   "description": "Custom icons to display next to the menu item. Custom icons can only be set for items appearing in submenus."
                 },
@@ -9971,7 +10024,14 @@
                   "optional": true
                 },
                 "icons": {
-                  "$ref": "MenuIconPath",
+                  "choices": [
+                    {
+                      "$ref": "MenuIconPath"
+                    },
+                    {
+                      "$ref": "MenuIconDictionary"
+                    }
+                  ],
                   "optional": "omit-key-if-missing"
                 },
                 "title": {
@@ -11284,9 +11344,20 @@
               "type": "string",
               "optional": true
             },
+            "decryptionStatus": {
+              "type": "string",
+              "optional": true,
+              "description": "The decryption status, only available for the root part.",
+              "enum": [
+                "none",
+                "skipped",
+                "success",
+                "fail"
+              ]
+            },
             "headers": {
               "type": "object",
-              "description": "A <em>dictionary object</em> of part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>",
+              "description": "A <em>dictionary object</em> of part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>.",
               "optional": true,
               "additionalProperties": {
                 "type": "array",
@@ -11595,6 +11666,18 @@
               "name": "messageId",
               "$ref": "messages.MessageId"
             },
+            {
+              "name": "options",
+              "type": "object",
+              "properties": {
+                "decrypt": {
+                  "type": "boolean",
+                  "description": "Whether the message should be decrypted. If the message could not be decrypted, its parts are omitted. Defaults to true.",
+                  "optional": true
+                }
+              },
+              "optional": true
+            },
             {
               "type": "function",
               "name": "callback",
@@ -11621,6 +11704,11 @@
               "name": "options",
               "type": "object",
               "properties": {
+                "decrypt": {
+                  "type": "boolean",
+                  "description": "Whether the message should be decrypted. Throws, if the message could not be decrypted.",
+                  "optional": true
+                },
                 "data_format": {
                   "choices": [
                     {
@@ -11641,7 +11729,8 @@
                         "BinaryString"
                       ]
                     }
-                  ]
+                  ],
+                  "optional": true
                 }
               },
               "optional": true
@@ -11737,7 +11826,7 @@
             {
               "name": "partNames",
               "type": "array",
-              "description": "An array of attachments, identifiying the to be detached attachments by their <value>partName</value>.",
+              "description": "An array of attachments, identifying the to be deleted attachments by their <value>partName</value>.",
               "items": {
                 "type": "string",
                 "pattern": "^\\d+(\\.\\d+)*$"
@@ -12032,7 +12121,7 @@
         {
           "name": "delete",
           "type": "function",
-          "description": "Deletes messages permanently, or moves them to the trash folder (honoring the account's deletion behavior settings). Deleting external messages will throw an <em>ExtensionError</em>. The ``skipTrash`` parameter allows immediate permanent deletion, bypassing the trash folder.\n**Note**: Consider using :ref:`messages.move` to manually move messages to the account's trash folder, instead of requesting the overly powerful permission to actually delete messages. The account's trash folder can be extracted as follows: <literalinclude>includes/messages/getTrash.js<lang>JavaScript</lang></literalinclude>",
+          "description": "Deletes messages permanently, or moves them to the trash folder (honoring the account's deletion behavior settings). Deleting external messages will throw an <em>ExtensionError</em>. The ``skipTrash`` parameter allows immediate permanent deletion, bypassing the trash folder.",
           "async": true,
           "permissions": [
             "messagesDelete"
@@ -12168,15 +12257,15 @@
             {
               "type": "string",
               "name": "color",
-              "description": "Tag color in hex format (i.e.: <value>#000080</value> for navy blue)",
-              "pattern": "^#[0-9a-f]{6}"
+              "description": "Tag color in hex format (i.e.: <value>#000080</value> for navy blue). Value will be stored as upper case.",
+              "pattern": "^#[0-9a-fA-F]{6}"
             }
           ]
         },
         {
           "name": "updateTag",
           "type": "function",
-          "description": "Updates a message tag.",
+          "description": "Updates a message tag. Throws if the specified tag key does not exist.",
           "async": true,
           "permissions": [
             "messagesTags"
@@ -12201,8 +12290,8 @@
                 },
                 "color": {
                   "type": "string",
-                  "pattern": "^#[0-9a-f]{6}",
-                  "description": "Tag color in hex format (i.e.: #000080 for navy blue).",
+                  "pattern": "^#[0-9a-fA-F]{6}",
+                  "description": "Tag color in hex format (i.e.: #000080 for navy blue). Value will be stored as upper case.",
                   "optional": "true"
                 }
               }
@@ -12328,15 +12417,15 @@
             {
               "type": "string",
               "name": "color",
-              "description": "Tag color in hex format (i.e.: #000080 for navy blue)",
-              "pattern": "^#[0-9a-f]{6}"
+              "description": "Tag color in hex format (i.e.: #000080 for navy blue). Value will be stored as upper case.",
+              "pattern": "^#[0-9a-fA-F]{6}"
             }
           ]
         },
         {
           "name": "update",
           "type": "function",
-          "description": "Updates a message tag.",
+          "description": "Updates a message tag. Throws if the specified tag key does not exist.",
           "async": true,
           "permissions": [
             "messagesTags"
@@ -12359,8 +12448,8 @@
                 },
                 "color": {
                   "type": "string",
-                  "pattern": "^#[0-9a-f]{6}",
-                  "description": "Tag color in hex format (i.e.: #000080 for navy blue).",
+                  "pattern": "^#[0-9a-fA-F]{6}",
+                  "description": "Tag color in hex format (i.e.: #000080 for navy blue). Value will be stored as upper case.",
                   "optional": "true"
                 }
               }
@@ -13293,7 +13382,7 @@
                 "url": {
                   "type": "string",
                   "optional": true,
-                  "description": "The URL to navigate the tab to initially. Fully-qualified URLs must include a scheme (i.e. <value>http://www.google.com</value>, not <value>www.google.com</value>). Relative URLs will be relative to the current page within the extension."
+                  "description": "The URL to navigate the tab to initially. If the URL points to a content page (a web page, an extension page or a registered WebExtension protocol handler page), the tab will navigate to the requested page. All other URLs will be opened externally after creating an empty tab. Fully-qualified URLs must include a scheme (i.e. <value>http://www.google.com</value>, not <value>www.google.com</value>). Relative URLs will be relative to the root of the extension. "
                 },
                 "active": {
                   "type": "boolean",
@@ -13947,6 +14036,95 @@
       ]
     }
   ],
+  "utilities.json": [
+    {
+      "namespace": "messengerUtilities",
+      "types": [
+        {
+          "id": "ParsedMailbox",
+          "type": "object",
+          "description": "Representation of a parsed mailbox string (see RFC 5322, section 3.4).",
+          "properties": {
+            "name": {
+              "type": "string",
+              "optional": true,
+              "description": "The <value>display-name</value> associated with the provided address or group, if available."
+            },
+            "email": {
+              "type": "string",
+              "optional": true,
+              "description": "The <value>addr-spec</value> associated with the provided address, if available."
+            },
+            "group": {
+              "type": "array",
+              "optional": true,
+              "items": {
+                "$ref": "messengerUtilities.ParsedMailbox"
+              },
+              "description": "The members of the group, if available."
+            }
+          }
+        }
+      ],
+      "functions": [
+        {
+          "name": "formatFileSize",
+          "type": "function",
+          "description": "Returns the provided file size in a human readable format (e.g. <value>12 bytes</value> or <value>11,4 GB</value>).",
+          "async": "callback",
+          "parameters": [
+            {
+              "type": "integer",
+              "name": "sizeInBytes",
+              "description": "The size in bytes."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "parseMailboxString",
+          "type": "function",
+          "description": "Parse a mailbox string containing one or more email addresses (see RFC 5322, section 3.4).",
+          "async": "callback",
+          "parameters": [
+            {
+              "type": "string",
+              "name": "mailboxString",
+              "description": "The string to be parsed (e.g. <value>User <user@example.com>, other-user@example.com</value>)"
+            },
+            {
+              "type": "boolean",
+              "name": "preserveGroups",
+              "optional": true,
+              "description": "Keep grouped hierachies. Groups may be specified in a mailbox string as follows: <value>GroupName : user1 <user1@example.com>, user2@example,com ;</value>."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "messengerUtilities.ParsedMailbox"
+                  }
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ],
   "windows.json": [
     {
       "namespace": "windows",
@@ -14198,7 +14376,7 @@
               "default": {},
               "properties": {
                 "url": {
-                  "description": "A URL or array of URLs to open as tabs in the window. Fully-qualified URLs must include a scheme (i.e. <value>http://www.google.com</value>, not <value>www.google.com</value>). Relative URLs will be relative to the current page within the extension. Defaults to the New Tab Page.",
+                  "description": "A URL to be opened in a popup window, ignored in all other window types. This may also be an array, but only the first element is used (popup windows may not have multiple tabs). If the URL points to a content page (a web page, an extension page or a registered WebExtension protocol handler page), the popup window will navigate to the requested page. All other URLs will be opened externally after creating an empty popup window. Fully-qualified URLs must include a scheme (i.e. <value>http://www.google.com</value>, not <value>www.google.com</value>). Relative URLs will be relative to the root of the extension. Defaults to the New Tab Page.",
                   "optional": true,
                   "choices": [
                     {