Index: content/public/browser/render_process_host_observer.h |
diff --git a/content/public/browser/render_process_host_observer.h b/content/public/browser/render_process_host_observer.h |
index 9414f57a6e6d3e42d9996be33fd1f89fc89d2a75..9f11c7b70b1a48c8a0135d6441037ec6499279ab 100644 |
--- a/content/public/browser/render_process_host_observer.h |
+++ b/content/public/browser/render_process_host_observer.h |
@@ -17,10 +17,22 @@ class RenderProcessHost; |
// in RenderProcessHost lifecycle events. |
class CONTENT_EXPORT RenderProcessHostObserver { |
public: |
+ // This method is invoked when the process is going to exit and should not be |
+ // used for further navigations. Note that this is a COURTESY callback, not |
+ // guaranteed to be called for any particular process. Because this is the |
+ // first step in an orderly shutdown of a render process, do not expect that |
ncarter (slow)
2015/07/21 20:58:28
This is a lot clearer, thanks!
|
+ // a new render process will be hosted with this RenderProcessHost. |
+ virtual void RenderProcessWillExit(RenderProcessHost* host) {} |
+ |
// This method is invoked when the process of the observed RenderProcessHost |
// exits (either normally or with a crash). To determine if the process closed |
// normally or crashed, examine the |status| parameter. |
// |
+ // A new render process may be spawned for this RenderProcessHost, but there |
+ // are no guarantees (e.g. if shutdown is occurring, the HostDestroyed |
+ // callback will happen soon and that will be it, but if the renderer crashed |
+ // and the user clicks 'reload', a new render process will be spawned). |
+ // |
// This will cause a call to WebContentsObserver::RenderProcessGone() for the |
// active renderer process for the top-level frame; for code that needs to be |
// a WebContentsObserver anyway, consider whether that API might be a better |
@@ -30,7 +42,9 @@ class CONTENT_EXPORT RenderProcessHostObserver { |
int exit_code) {} |
// This method is invoked when the observed RenderProcessHost itself is |
- // destroyed. This is guaranteed to be the last call made to the observer. |
+ // destroyed. This is guaranteed to be the last call made to the observer, so |
+ // if the observer is tied to the observed RenderProcessHost, it is safe to |
+ // delete it. |
virtual void RenderProcessHostDestroyed(RenderProcessHost* host) {} |
protected: |