Add new fields for Purge+Suspend to WebContentsData.

chrome/browser/memory/tab_manager.h

Index: chrome/browser/memory/tab_manager.h
diff --git a/chrome/browser/memory/tab_manager.h b/chrome/browser/memory/tab_manager.h
index 9dc86df35fb7da85d33e17f02a3eae04f168d72e..1196c08dcdf5d62b2ae05634b0ef3f88caa58292 100644
--- a/chrome/browser/memory/tab_manager.h
+++ b/chrome/browser/memory/tab_manager.h
@@ -173,9 +173,11 @@ class TabManager : public TabStripModelObserver {
   FRIEND_TEST_ALL_PREFIXES(TabManagerTest, ProtectVideoTabs);
   FRIEND_TEST_ALL_PREFIXES(TabManagerTest, ReloadDiscardedTabContextMenu);
   FRIEND_TEST_ALL_PREFIXES(TabManagerTest, TabManagerBasics);
+  FRIEND_TEST_ALL_PREFIXES(TabManagerWebContentsDataTest, PurgeAndSuspendState);
 
-  // This is needed so WebContentsData can call OnDiscardedStateChange.
-  friend class WebContensData;
+  // This is needed so WebContentsData can call OnDiscardedStateChange, and
+  // can use PurgeAndSuspendState.
+  friend class WebContentsData;
 
   // Called by WebContentsData whenever the discard state of a WebContents
   // changes, so that observers can be informed.
@@ -247,6 +249,28 @@ class TabManager : public TabStripModelObserver {
   // that need to be run periodically (see comment in implementation).
   void UpdateTimerCallback();
 
+  // Initially PurgeAndSuspendState is RUNNING.
+  // RUNNING => SUSPENDED
+  // - A tab has been backgrounded for more than purge-and-suspend-time
+  //   seconds.
+  // SUSPENDED => RESUMED
+  // - A suspended tab is still suspended (i.e. last active time < last
+  //   purge-and-suspend modified time), and
+  // - kMaxTimeRendererAllowedToBeSuspendedBeforeResume time passes since
+  //   since the tab was suspended.
+  // RESUMED => SUSPENDED
+  // - A resumed tab is still backgrounded (i.e. last active time < last
+  //   purge-and-suspend modified time), and
+  // - kSuspendedRendererLengthOfResumption time passes since the tab was
+  //   resumed.
+  // SUSPENDED, RESUMED, RUNNING => RUNNING
+  // - When ActiveTabChaged, the newly activated tab's state will be RUNNING.
+  enum PurgeAndSuspendState {
+    RUNNING,
+    RESUMED,
+    SUSPENDED,
+  };
+
   // Purges and suspends renderers in backgrounded tabs.
   void PurgeAndSuspendBackgroundedTabs();