Paramétrage de l’agent d’utilisateur employé lors du chargement du contenu HTML

Adobe AIR 1.0 et les versions ultérieures

La classe HTMLLoader possède une propriété userAgent qui vous permet de définir la chaîne de l’agent d’utilisateur employé par HTMLLoader. Paramétrez la propriété userAgent de l’objet HTMLLoader avant d’appeler la méthode load(). Si vous définissez cette propriété sur l’occurrence de HTMLLoader, la propriété userAgent de l’URLRequest transmise à la méthode load() n’est alors pas utilisée.

Vous pouvez définir la chaîne de l’agent d’utilisateur employée par tous les objets HTMLLoader dans un domaine d’application en paramétrant la propriété URLRequestDefaults.userAgent. Les propriétés URLRequestDefaults statiques sont appliquées par défaut à tous les objets URLRequest, et pas seulement aux objets URLRequest utilisés avec la méthode load() des objets HTMLLoader. Le paramétrage de la propriété userAgent d’un HTMLLoader remplace celui par défaut de URLRequestDefaults.userAgent.

Si vous ne paramétrez pas une valeur de l’agent d’utilisateur pour la propriété userAgent de l’objet HTMLLoader ou pour URLRequestDefaults.userAgent, la valeur de l’agent d’utilisateur AIR par défaut est employée. Cette valeur par défaut varie suivant le système d’exploitation utilisé à l’exécution (Mac OS ou Windows, par exemple), le langage du moteur d’exécution et sa version, comme dans les deux exemples suivants :

  • "Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"

  • "Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"