| // Copyright 2015 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 CHROME_BROWSER_UI_COCOA_HAS_WEAK_BROWSER_POINTER_H_ |
| #define CHROME_BROWSER_UI_COCOA_HAS_WEAK_BROWSER_POINTER_H_ |
| |
| // This allows reference counted objects holding a Browser* to be |
| // notified that the Browser will be destroyed so they can invalidate their |
| // Browser*, perform any necessary cleanup, and pass the notification onto any |
| // objects they retain that also implement this protocol. This helps to prevent |
| // use-after-free of Browser*, or anything else tied to the Browser's lifetime, |
| // by objects that may be retained beyond the lifetime of their associated |
| // Browser (e.g. NSViewControllers). |
| @protocol HasWeakBrowserPointer |
| @required |
| // This is usually called by BrowserWindowController but can be called by any |
| // object that's certain of Browser's destruction. |
| - (void)browserWillBeDestroyed; |
| @end |
| |
| #endif // CHROME_BROWSER_UI_COCOA_HAS_WEAK_BROWSER_POINTER_H_ |
