MDN may have intermittent access issues April 18 13:00 - April 19 01:00 UTC. See whistlepig.mozilla.org for all notifications.

mozilla

Revision 39507 of Components.utils.unload

  • Revision slug: Components.utils.unload
  • Revision title: Components.utils.unload
  • Revision id: 39507
  • Created:
  • Creator: Sheppy
  • Is current revision? No
  • Comment one or more formatting changes
Tags: 

Revision Content

{{ Gecko_minversion_header("7.0") }}

This method was introduced in Firefox 7 and is used to unload JavaScript code modules.

Once this method has been called, references to the module will continue to work but any subsequent import of the module will reload it and give a new reference. If the JavaScript code module has not yet been imported then this method will do nothing.

Syntax

Components.utils.unload( url );

Parameters

url
A string of the URL of the script to unload. This must be the same URL that was used to load the script.

Example

Components.utils.unload("resource://gre/modules/XPCOMUtils.jsm");

Additional Resources

  • {{ bug("481603") }}
  • The documentation in {{ Source("js/src/xpconnect/idl/xpccomponents.idl", "xpccomponents.idl") }}
  • The tests in {{ Source("js/src/xpconnect/tests/unit/") }}

Revision Source

<p>{{ Gecko_minversion_header("7.0") }}</p>
<p>This method was introduced in <a href="/en/Firefox_7_for_developers" title="en/Firefox_7_for_developers">Firefox 7</a> and is used to unload <a href="/en/JavaScript_code_modules" title="en/JavaScript code modules">JavaScript code modules</a>.</p>
<p>Once this method has been called, references to the module will continue to work but any subsequent import of the module will reload it and give a new reference. If the JavaScript code module has not yet been imported then this method will do nothing.</p>
<h3 name="Syntax">Syntax</h3>
<pre>Components.utils.unload( <em>url</em> );
</pre>
<h3 name="Parameters">Parameters</h3>
<dl> <dt><code>url</code></dt> <dd>A string of the URL of the script to unload. This must be the same URL that was used to load the script.</dd>
</dl>
<h3 name="Example">Example</h3>
<pre class="eval">Components.utils.unload("<span class="nowiki">resource://gre/modules/XPCOMUtils.jsm</span>");
</pre>
<h3 name="Additional_Resources">Additional Resources</h3>
<ul> <li>{{ bug("481603") }}</li> <li>The documentation in {{ Source("js/src/xpconnect/idl/xpccomponents.idl", "xpccomponents.idl") }}</li> <li>The tests in {{ Source("js/src/xpconnect/tests/unit/") }}</li>
</ul>
Revert to this revision