files/ja/mozilla/javascript_code_modules/components.utils.unload/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

---
title: Components.utils.unload
slug: Mozilla/JavaScript_code_modules/Components.utils.unload
tags:
  - Modules
translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.unload
---
<p>{{ Gecko_minversion_header("7.0") }}</p>

<p><code><a href="/ja/docs/Components.utils">Components.utils</a>.unload</code> は<a href="/ja/Firefox_7_for_developers" title="ja/Firefox_7_for_developers">Firefox 7</a> で導入され、 <a href="/ja/JavaScript_code_modules" title="ja/JavaScript code modules">JavaScript コードモジュール</a>をアンロードするために使用されています。これは特に<a href="/ja/Extensions/Bootstrapped_extensions" title="ja/Extensions/Bootstrapped_extensions">再起動不要な（ブートストラップ型）拡張機能</a>において、新しいバージョンの拡張機能をインストールするときに古いバージョンのコードモジュールをアンロードしたいときに便利です。</p>

<p>このメソッドが呼び出されると、モジュールへの参照は引き続き機能しますが、それ以降にモジュールがインポートされるとリロードして新しい参照を与えます。 JavaScript コードモジュールがまだインポートされていない場合、このメソッドは何も行いません。</p>

<p>アプリケーションの一部であるモジュール（<code><a class="external" rel="freelink">resource://gre/</a></code> や <code>resource:///</code> や <code><a class="external" rel="freelink">resource://app/</a></code>）は、他の拡張機能やアプリケーションによって利用されている可能性があるので、アンロードするべきではありません。拡張機能の一部としてインクルードしたモジュールのみをアンロードしてください。</p>

<h3 id="Syntax" name="Syntax">構文</h3>

<pre>Components.utils.unload( <em>url</em> );
</pre>

<h3 id="Parameters" name="Parameters">引数</h3>

<dl>
 <dt><code>url</code></dt>
 <dd>アンロードするスクリプトの "resource://" で始まる URL です。スクリプトをロードするために使用したものと同じ URL である必要があります。</dd>
</dl>

<h3 id="Example" name="Example">例</h3>

<p>以下の1行のコードで、 MyModule.jsm と呼ばれるモジュールをアンロードできます。</p>

<pre class="eval">Components.utils.unload("<span class="nowiki">resource://myaddon/modules/MyModule.jsm</span>");
</pre>

<div class="note"><strong>注:</strong> 現在、 Components.utils.unload clears はアンロードするモジュールのグローバルオブジェクトをクリアします。これによってアンロードにそれらへの参照を使用すると、モジュールが誤動作する可能性があります。 {{ bug("769253") }} を参照してください。</div>

<h3 id="See_also" name="See_also">関連情報</h3>

<ul>
 <li>{{ bug("481603") }}</li>
 <li>{{ Source("js/xpconnect/idl/xpccomponents.idl", "xpccomponents.idl") }} のドキュメント</li>
 <li>{{ Source("js/xpconnect/tests/unit/") }} のテスト</li>
</ul>