L'objet Components est l'objet au travers duquel les fonctionnalités XPConnect sont reflétées en JavaScript. Il s'agit en réalité d'une instance native de l'interface nsIXPCComponents qui est reflétée en JavaScript comme un objet de niveau global à l'aide d'XPConnect.
Certaines propriétés de Components ont besoin de privilèges élevés et peuvent ne pas fonctionner dans des pages Web.
L'objet Components dispose des membres suivants :
| Membre | Description |
|---|---|
classes |
tableau de classes par ContractID |
classesByID |
tableau de classes par CID |
Constructor |
constructeur de constructeur de composants |
Exception |
constructeur d'exception XPConnect |
ID |
constructeur de nsID XPCOM |
interfaces |
tableau d'interfaces par nom d'interface |
interfacesByID |
tableau d'interfaces par IID |
isSuccessCode |
fonction pour déterminer si un résultat donné est un code de réussite |
lastResult |
code de résultat de l'appel XPConnect le plus récent |
manager |
le gestionnaire global de composants XPCOM |
results |
tableau des codes de résultats connus par nom |
returnCode |
résultat en attente pour l'appel courant |
stack |
pile d'appels JavaScript courante |
utils |
donne accès à différentes fonctionnalités utiles |
utils.evalInSandbox |
Lance du code JavaScript dans une sandbox, généralement pour lancer du code à privilèges restreints. |
utils.forceGC |
Force un cycle de garbage collection. |
utils.getWeakReference |
Obtient une référence faible à l'objet passé. |
utils.import |
Charge un module JS dans le script courant, sans partager de visibilité. |
utils.lookupMethod |
Examine une méthode ou propriété native (c'est-à-dire déclaré dans l'interface) d'un objet XPCOM. Sert à la même chose que XPCNativeWrapper. |
utils.reportError |
Rapporte un objet d'erreur JavaScript dans la Console d'erreurs. |
utils.Sandbox |
Crée des objets de sandbox pout utiliser avec |
utils- provides access to several useful features
-
utils.atline- Provides access to the value of the
atlineproperty in the JavaScript environment. utils.createObjectIn- Creates a new object in the scope of the specified object's compartment. May only be called from JavaScript code.
utils.evalInSandbox- Runs JavaScript code in a sandbox, usually used to run code with restricted privileges.
utils.forceGC- Forces a garbage collection cycle.
utils.getGlobalForObject- Returns the global object with which a given object is associated (through its prototype chain at birth, for example).
utils.getWeakReference- Gets a weak reference for the object passed in.
utils.import- Loads a JavaScript module into the current script, without sharing a scope.
utils.lookupMethod- Looks up a native (i.e. declared in the interface) method or property of an XPCOM object. Serves the same purpose as XPCNativeWrapper.
- utils.makeObjectPropsNormal
- Ensures that all functions come from the specified object's scope, and aren't cross-compartment wrappers. May only be called from JavaScript code.
utils.methodjitObsolète depuis Gecko 24.0- Provides access to the value of the
methodjitproperty in the JavaScript environment.
utils.methodjit_alwaysObsolète depuis Gecko 24.0- Provides access to the value of the
methodjit_alwaysproperty in the JavaScript environment.
utils.relimit- Provides access to the value of the
relimitproperty in the JavaScript environment.
utils.reportError- Reports a JavaScript Error object to the Error Console.
utils.schedulePreciseGC- Requests that garbage collection occur sometime in the future when no JavaScript code is running; accepts a callback function to receive notification once collection is complete.
utils.setGCZeal()- Sets the GC zeal level for the context.
utils.strict- Provides access to the value of the
strictproperty in the JavaScript environment.
utils.werror- Provides access to the value of the
werrorproperty in the JavaScript environment.
utils.Sandbox- Creates sandbox objects for use with
evalInSandbox. utils.xml- Provides access to the value of the
xmlproperty in the JavaScript environment.