In order to avoid confusion regarding which extension will win, users should not install extensions that may conflict. If more than one extension overrides the filename, then the last extension installed whose listener passes a suggestion object to suggest wins. Listeners may call suggest without any arguments in order to allow the download to use downloadItem.filename for its filename, or pass a suggestion object to suggest in order to override the target filename. The DownloadItem will not complete until all listeners have called suggest. If the listener neither calls suggest synchronously nor returns true, then suggest will be called automatically. If the listener calls suggest asynchronously, then it must return true. Each listener must call suggest exactly once, either synchronously or asynchronously. Each extension may not register more than one listener for this event.
OnDeterminingFilename (ĭuring the filename determination process, extensions will be given the opportunity to override the target DownloadItem.filename.
