--- title: Components.utils slug: Components.utils tags: - 'XPCOM:Liaisons_de_langage' - XPConnect translation_of: Mozilla/Tech/XPCOM/Language_Bindings/Components.utils ---

Components.utils est une collection de diverses fonctionnalités utiles à XPConnect. Son interface est définie dans js/xpconnect/idl/xpccomponents.idl. Cet objet a actuellement les membres suivants :

REDACTEURS! Veuillez garder cette liste synchronisée avec la page Components object

Méthodes

Méthode Description
createObjectIn() Crée un nouvel objet, créé dans le cadre du compartiment de l'objet spécifié.
evalInSandbox Exécute du code JavaScript dans une sandbox, généralement utilisé pour exécuter un code avec des privilèges restreints.
forceGC Force un cycle de ramasse-miettes.
getGlobalForObject() Renvoie l'objet global avec lequel un objet donné est associé (à travers sa chaîne prototype à sa naissance, par exemple).
getWeakReference Obtient une faible référence de l'objet passé.
import Charge un module JS dans le script courant, sans partager de visibilité.
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.
makeObjectPropsNormal() S'assure que toutes les fonctions viennent du champ d'application de l'objet spécifié, et les enveloppes des compartiments ne sont pas croisées. Ne peut être appelée qu'à partir de code JavaScript.
reportError Rapporte l'erreur d'un objet JavaScript dans la Console d'erreurs.
schedulePreciseGC() Prévoit un cycle de ramasse-miettes au cours duquel aucun code JavaScript ne sera exécuté. Cela vous permet de spécifier un rappel afin que vous puissiez être averti lorsque le cycle de ramasse-miettes a été effectué.
setGCZeal() Règle le niveau du ramasse-miettes pour une collecte complète. Voir JS_SetGCZeal pour plus de détails, cette méthode appelle par le biais de la valeur spécifiée comme la valeur zeal.

Propriétés


Propriété Type Description
Sandbox nsIXPCComponents_utils_Sandbox Crée des objets sandbox pout être utilisés avec evalInSandbox.
atline Booléen Lorsque atline est activé, les comemntaires de la forme //@line num définissent le nombre de la ligne suivante à num. Cela reflète la valeur de l'option de l'environnement JavaScript par le même nom. lecture seule.
methodjit Booléen Cela reflète la valeur de l'option de l'environnement JavaScript par le même nom. lecture seule.
methodjit_always Booléen Cela reflète la valeur de l'option de l'environnement JavaScript par le même nom. lecture seule.
relimit Booléen Cela reflète la valeur de l'option de l'environnement JavaScript par le même nom. lecture seule.
strict Booléen le mode strict est activé. Cela reflète la valeur de l'option de l'environnement JavaScript par le même nom. lecture seule.
werror Booléen Les avertissements doivent être traités comme des erreurs. Cela reflète la valeur de l'option de l'environnement JavaScript par le même nom. lecture seule.
xml Booléen Le mode XML est activé. Cela reflète la valeur de l'option de l'environnement JavaScript par le même nom. lecture seule.