Objet Components

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 evalInSandbox.

 

 
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.

 

 

Components object (en)