Discarded property on chrome.tabs.Tab and chrome.tabs.query()

chrome/common/extensions/api/tabs.json

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 [
   {
     "namespace": "tabs",
     "description": "Use the <code>chrome.tabs</code> API to interact with the browser's tab system. You can use this API to create, modify, and rearrange tabs in the browser.",
     "types": [
       { "id": "MutedInfoReason",
@@ skipping 33 matching lines @@
           "id": {"type": "integer", "minimum": -1, "optional": true, "description": "The ID of the tab. Tab IDs are unique within a browser session. Under some circumstances a Tab may not be assigned an ID, for example when querying foreign tabs using the $(ref:sessions) API, in which case a session ID may be present. Tab ID can also be set to chrome.tabs.TAB_ID_NONE for apps and devtools windows."},
           // TODO(kalman): Investigate how this is ending up as -1 (based on window type? a bug?) and whether it should be optional instead.
           "index": {"type": "integer", "minimum": -1, "description": "The zero-based index of the tab within its window."},
           "windowId": {"type": "integer", "minimum": 0, "description": "The ID of the window the tab is contained within."},
           "openerTabId": {"type": "integer", "minimum": 0, "optional": true, "description": "The ID of the tab that opened this tab, if any. This property is only present if the opener tab still exists."},
           "selected": {"type": "boolean", "description": "Whether the tab is selected.", "deprecated": "Please use $(ref:tabs.Tab.highlighted)."},
           "highlighted": {"type": "boolean", "description": "Whether the tab is highlighted."},
           "active": {"type": "boolean", "description": "Whether the tab is active in its window. (Does not necessarily mean the window is focused.)"},
           "pinned": {"type": "boolean", "description": "Whether the tab is pinned."},
           "audible": {"type": "boolean", "optional": true, "description": "Whether the tab has produced sound over the past couple of seconds (but it might not be heard if also muted). Equivalent to whether the speaker audio indicator is showing."},
+          "discarded": {"type": "boolean", "description": "Whether the tab is discarded, meaning that its content has been unloaded from memory but the tab still exists in the tab-strip. The content will be reloaded if the tab gets activated."},

[Georges Khalil, 2016/06/21 15:31:20]

nit: I would rephrase this like this:

Whether the tab is discarded. A discarded tab is one whose content has been
unloaded from memory, but is still visible in the tab strip. Its content gets
reloaded the next time it's activated.

[Anderson Silva, 2016/06/27 18:21:53]

Done.

           "mutedInfo": {"$ref": "MutedInfo", "optional": true, "description": "Current tab muted state and the reason for the last state change."},
           "url": {"type": "string", "optional": true, "description": "The URL the tab is displaying. This property is only present if the extension's manifest includes the <code>\"tabs\"</code> permission."},
           "title": {"type": "string", "optional": true, "description": "The title of the tab. This property is only present if the extension's manifest includes the <code>\"tabs\"</code> permission."},
           "favIconUrl": {"type": "string", "optional": true, "description": "The URL of the tab's favicon. This property is only present if the extension's manifest includes the <code>\"tabs\"</code> permission. It may also be an empty string if the tab is loading."},
           "status": {"type": "string", "optional": true, "description": "Either <em>loading</em> or <em>complete</em>."},
           "incognito": {"type": "boolean", "description": "Whether the tab is in an incognito window."},
           "width": {"type": "integer", "optional": true, "description": "The width of the tab in pixels."},
           "height": {"type": "integer", "optional": true, "description": "The height of the tab in pixels."},
           "sessionId": {"type": "string", "optional": true, "description": "The session ID used to uniquely identify a Tab obtained from the $(ref:sessions) API."}
         }
@@ skipping 376 matching lines @@
               "muted": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tabs are muted."
               },
               "highlighted": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tabs are highlighted."
               },
+              "discarded": {
+                "type": "boolean",
+                "optional": true,
+                "description": "Whether the tabs are discarded, meaning that its content has been unloaded from memory but the tabs still exists in the tab-strip. The content will be reloaded if the tab gets activated."
+              },

[Georges Khalil, 2016/06/21 15:31:20]

nit: same as above.

[Anderson Silva, 2016/06/27 18:21:53]

Done.

               "currentWindow": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tabs are in the <a href='windows#current-window'>current window</a>."
               },
               "lastFocusedWindow": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tabs are in the last focused window."
               },
@@ skipping 718 matching lines @@
             "tabId": {"type": "integer", "minimum": 0},
             "oldZoomFactor": {"type": "number"},
             "newZoomFactor": {"type": "number"},
             "zoomSettings": {"$ref": "ZoomSettings"}
           }
         }]
       }
     ]
   }
 ]