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)