mozilla

Compare Revisions

Downloads.jsm

Change Revisions

Revision 482027:

Revision 482027 by P.A. on

Revision 482055:

Revision 482055 by P.A. on

Title:
Downloads.jsm
Downloads.jsm
Slug:
Mozilla/JavaScript_code_modules/Downloads.jsm
Mozilla/JavaScript_code_modules/Downloads.jsm
Content:

Revision 482027
Revision 482055
tt361    <h2 id="Conversion_from_nsIDownloadManager">
362      Conversion from nsIDownloadManager
363    </h2>
364    <p>
365      Starting in Firefox for Desktop version 26, the {{interface
 >("nsIDownloadManager")}} and {{interface("nsIDownload")}} interfa
 >ces are not available anymore.
366    </p>
367    <p>
368      The new module works differently from the old component. In
 > general, you should be aware of the following highlights:
369    </p>
370    <ul>
371      <li>There is no difference between active downloads and fin
 >ished downloads. The <a href="/en-US/docs/Mozilla/JavaScript_code
 >_modules/Downloads.jsm/Download" title="/en-US/docs/Mozilla/JavaS
 >cript_code_modules/Downloads.jsm/Download"><code>Download</code><
 >/a> object can be used without requiring direct database access.
372      </li>
373      <li>Observer notifications (for example, <code>"dl-done"</c
 >ode>) and download listeners are replaced by views on the <a href
 >="/en-US/docs/Mozilla/JavaScript_code_modules/Downloads.jsm/Downl
 >oadList" title="/en-US/docs/Mozilla/JavaScript_code_modules/Downl
 >oads.jsm/DownloadList"><code>DownloadList</code></a> object retur
 >ned by the <a href="#getList()" title="#getList()"><code>getList(
 >)</code></a> method.
374      </li>
375      <li>There is no separate count of active downloads. If a co
 >unt is needed, it should be maintained using a view on a <code>Do
 >wnloadList</code>.
376      </li>
377      <li>The <a href="/en-US/docs/Mozilla/JavaScript_code_module
 >s/Downloads.jsm/Download#start()" title="/en-US/docs/Mozilla/Java
 >Script_code_modules/Downloads.jsm/Download#start()">start()</a> m
 >ethod can be used to restart a failed download. Handling of downl
 >oads that have been paused is also different.
378      </li>
379    </ul>
380    <p>
381      While some of the legacy methods and properties have an equ
 >ivalent in <code>Downloads.jsm</code>, there might be subtle diff
 >erences in behavior. For example, the properties that handle prog
 >ress are now more detailed and don't use the special value <code>
 >-1</code> anymore. You may see the documentation of the new metho
 >ds and propeties for details.
382    </p>

Back to History