Service Worker: set active worker to REDUNDANT when unregistered

content/browser/service_worker/service_worker_version.h

 // Copyright 2013 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 CONTENT_BROWSER_SERVICE_WORKER_SERVICE_WORKER_VERSION_H_
 #define CONTENT_BROWSER_SERVICE_WORKER_SERVICE_WORKER_VERSION_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 45 matching lines @@
     STOPPING = EmbeddedWorkerInstance::STOPPING,
   };
 
   // Current version status; some of the status (e.g. INSTALLED and ACTIVATED)
   // should be persisted unlike running status.
   enum Status {
     NEW,         // The version is just created.
     INSTALLING,  // Install event is dispatched and being handled.
     INSTALLED,   // Install event is finished and is ready to be activated.
     ACTIVATING,  // Activate event is dispatched and being handled.
-    ACTIVATED,      // Activation is finished and can run as activated.
+    ACTIVATED,   // Activation is finished and can run as activated.
     REDUNDANT,   // The version is no longer running as activated, due to
                  // unregistration or replace.
   };
 
   class Listener {
    public:
     virtual void OnWorkerStarted(ServiceWorkerVersion* version) {};
     virtual void OnWorkerStopped(ServiceWorkerVersion* version) {};
     virtual void OnVersionStateChanged(ServiceWorkerVersion* version) {};
     virtual void OnErrorReported(ServiceWorkerVersion* version,
                                  const base::string16& error_message,
                                  int line_number,
                                  int column_number,
                                  const GURL& source_url) {};
     virtual void OnReportConsoleMessage(ServiceWorkerVersion* version,
                                         int source_identifier,
                                         int message_level,
                                         const base::string16& message,
                                         int line_number,
                                         const GURL& source_url) {};
+    // Fired when a version that was the controller of a page no longer controls
+    // any pages.
     virtual void OnNoControllees(ServiceWorkerVersion* version) {};
   };
 
   ServiceWorkerVersion(
       ServiceWorkerRegistration* registration,
       int64 version_id,
       base::WeakPtr<ServiceWorkerContextCore> context);
 
   int64 version_id() const { return version_id_; }
   int64 registration_id() const { return registration_id_; }
@@ skipping 20 matching lines @@
 
   // Starts an embedded worker for this version.
   // |potential_process_ids| is a list of processes in which to start the
   // worker.
   // This returns OK (success) if the worker is already running.
   void StartWorkerWithCandidateProcesses(
       const std::vector<int>& potential_process_ids,
       bool pause_after_download,
       const StatusCallback& callback);
 
-  // Stops an embedded worker for this version.
+  // Stops the embedded worker for this version.
   // This returns OK (success) if the worker is already stopped.
   void StopWorker(const StatusCallback& callback);
 
   // Schedules an update to be run 'soon'.
   void ScheduleUpdate();
 
   // If an update is scheduled but not yet started, this resets the timer
   // delaying the start time by a 'small' amount.
   void DeferScheduledUpdate();
 
@@ skipping 63 matching lines @@
   bool HasProcessToRun() const;
 
   // Adds and removes |provider_host| as a controllee of this ServiceWorker.
   // A potential controllee is a host having the version as its .installing
   // or .waiting version.
   void AddControllee(ServiceWorkerProviderHost* provider_host);
   void RemoveControllee(ServiceWorkerProviderHost* provider_host);
   void AddPotentialControllee(ServiceWorkerProviderHost* provider_host);
   void RemovePotentialControllee(ServiceWorkerProviderHost* provider_host);
 
-  // Returns if it has controllee.
+  // Returns true if it has a controllee, excluding potential ones.
   bool HasControllee() const { return !controllee_map_.empty(); }
 
   // Adds and removes Listeners.
   void AddListener(Listener* listener);
   void RemoveListener(Listener* listener);
 
   ServiceWorkerScriptCacheMap* script_cache_map() { return &script_cache_map_; }
   EmbeddedWorkerInstance* embedded_worker() { return embedded_worker_.get(); }
 
  private:
@@ skipping 67 matching lines @@
   base::OneShotTimer<ServiceWorkerVersion> update_timer_;
 
   base::WeakPtrFactory<ServiceWorkerVersion> weak_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(ServiceWorkerVersion);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_SERVICE_WORKER_SERVICE_WORKER_VERSION_H_