Introduce WebStateList to manage a list of web::WebState.

ios/shared/chrome/browser/tabs/web_state_list_observer.h

+// Copyright 2017 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.
+
+#ifndef IOS_SHARED_CHROME_BROWSER_TABS_WEB_STATE_LIST_OBSERVER_H_
+#define IOS_SHARED_CHROME_BROWSER_TABS_WEB_STATE_LIST_OBSERVER_H_
+
+#include "base/macros.h"
+
+class WebStateList;
+
+namespace web {
+class WebState;
+}
+
+// Interface for listening to events occurring to WebStateLists.
+class WebStateListObserver {
+ public:
+  WebStateListObserver() = default;
+  virtual ~WebStateListObserver() = default;
+
+  // Invoked after a new WebState has been added to the WebStateList at the
+  // specified index.
+  virtual void WebStateInsertedAt(WebStateList* web_state_list,
+                                  web::WebState* web_state,
+                                  size_t index) = 0;
+
+  // Invoked after the WebState at the specified index is moved to another
+  // index.
+  virtual void WebStateMoved(WebStateList* web_state_list,
+                             web::WebState* web_state,
+                             size_t from_index,
+                             size_t to_index) = 0;
+
+  // Invoked after the WebState at the specified index is replaced by another
+  // WebState.
+  virtual void WebStateReplacedAt(WebStateList* web_state_list,
+                                  web::WebState* old_web_state,
+                                  web::WebState* new_web_state,
+                                  size_t index) = 0;
+
+  // Invoked after the WebState at the specified index is being detached. The

[rohitrao (ping after 24h), 2017/02/14 13:49:31]

"has been detached"

[sdefresne, 2017/02/14 15:26:35]

Done.

+  // WebState is still valid but is no longer in the WebStateList.
+  virtual void WebStateDetachedAt(WebStateList* web_state_list,
+                                  web::WebState* web_state,
+                                  size_t index) = 0;
+
+ private:
+  DISALLOW_COPY_AND_ASSIGN(WebStateListObserver);
+};
+
+#endif  // IOS_SHARED_CHROME_BROWSER_TABS_WEB_STATE_LIST_OBSERVER_H_