Chromium Code Reviews| 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: |