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
atline
property 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.methodjit
Obsolète depuis Gecko 24.0- Provides access to the value of the
methodjit
property in the JavaScript environment.
utils.methodjit_always
Obsolète depuis Gecko 24.0- Provides access to the value of the
methodjit_always
property in the JavaScript environment.
utils.relimit
- Provides access to the value of the
relimit
property 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
strict
property in the JavaScript environment.
utils.werror
- Provides access to the value of the
werror
property in the JavaScript environment.
utils.Sandbox
- Creates sandbox objects for use with
evalInSandbox
. utils.xml
- Provides access to the value of the
xml
property in the JavaScript environment.