| Package | flash.events |
| Classe | public class HTTPStatusEvent |
| Héritage | HTTPStatusEvent Event Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Les objets HTTPStatusEvent sont toujours envoyés avant les événements d'erreur ou d'achèvement. Un objet HTTPStatusEvent n'indique pas nécessairement une erreur. Il reflète simplement le code d'état HTTP (s'il existe) fourni par la pile réseau. Certains environnements Flash Player ne peuvent pas détecter les codes d'état HTTP. Dans ce cas, le code d'état 0 est systématiquement renvoyé.
Dans Flash Player, il n'existe qu'un type d'événement HTTPStatus : httpStatus. Dans le moteur d'exécution AIR, un FileReference, URLLoader, ou URLStream peut enregistrer pour écouter un httpResponseStatus, qui inclut des propriétés responseURL et responseHeaders. Ces propriétés ne sont pas définies dans un événement httpStatus.
| Propriété | Défini par | ||
|---|---|---|---|
![]() | bubbles : Boolean [lecture seule] Indique si un événement peut se propager vers le haut (bubbling). | Event | |
![]() | cancelable : Boolean [lecture seule] Indique si le comportement associé à l'événement peut être annulé. | Event | |
![]() | constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet. | Object | |
![]() | currentTarget : Object [lecture seule] L'objet qui traite activement l'objet Event avec un écouteur d'événements. | Event | |
![]() | eventPhase : uint [lecture seule] Phase actuelle du flux d'événements. | Event | |
![]() | prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction. | Object | |
Les en-têtes de réponse que la réponse a renvoyés, sous la forme d'un tableau d'objets URLRequestHeader. | HTTPStatusEvent | ||
L'URL à partir de laquelle la réponse à été renvoyée. | HTTPStatusEvent | ||
| status : int [lecture seule] Le code d'état HTTP renvoyé par le serveur. | HTTPStatusEvent | ||
![]() | target : Object [lecture seule] Cible de l'événement. | Event | |
![]() | type : String [lecture seule] Type d'événement. | Event | |
| Méthode | Défini par | ||
|---|---|---|---|
Crée un objet Event contenant des informations sur les événements HTTPStatus. | HTTPStatusEvent | ||
Crée une copie de l'objet HTTPStatusEvent et définit la valeur de chaque propriété de sorte qu'elle corresponde à la valeur d'origine. | HTTPStatusEvent | ||
![]() | Fonction d'un utilitaire permettant d'implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | |
![]() | Indique si la propriété spécifiée d'un objet est définie. | Object | |
![]() | Vérifie si la méthode preventDefault() a été appelée pour l'événement. | Event | |
![]() | Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre. | Object | |
![]() | Annule le comportement par défaut d'un événement si cette opération est possible. | Event | |
![]() | Indique si la propriété spécifiée existe et est énumérable. | Object | |
![]() | Définit la disponibilité d'une propriété dynamique pour les opérations en boucle. | Object | |
![]() | Bloque le traitement des écouteurs d'événement dans le nœud actuel et les suivants dans le flux d'événements. | Event | |
![]() | Bloque le traitement des écouteurs d'événement dans les nœuds qui suivent le nœud actuel dans le flux d'événements. | Event | |
Renvoie une chaîne répertoriant toutes les propriétés de l'objet HTTPStatusEvent. | HTTPStatusEvent | ||
![]() | Renvoie la valeur primitive de l'objet spécifié. | Object | |
| Constante | Défini par | ||
|---|---|---|---|
![]() | ACTIVATE : String = "activate" [statique] La constante ACTIVATE définit la valeur de la propriété type d'un objet événement activate. | Event | |
![]() | ADDED : String = "added" [statique] La constante Event.ADDED définit la valeur de la propriété type d'un objet événement added. | Event | |
![]() | ADDED_TO_STAGE : String = "addedToStage" [statique] La constante Event.ADDED_TO_STAGE définit la valeur de la propriété type d'un objet d'événement addedToStage. | Event | |
![]() | CANCEL : String = "cancel" [statique] La constante Event.CANCEL définit la valeur de la propriété type d'un objet événement cancel. | Event | |
![]() | CHANGE : String = "change" [statique] La constante Event.CHANGE définit la valeur de la propriété type de l'objet d'événement change. | Event | |
![]() | CLEAR : String = "clear" [statique] La constante Event.CLEAR définit la valeur de la propriété type d'un objet événement clear. | Event | |
![]() | CLOSE : String = "close" [statique] La constante Event.CLOSE définit la valeur de la propriété type d'un objet événement close. | Event | |
![]() | [statique] La constante Event.CLOSING définit la valeur de la propriété type d'un objet événement closing. | Event | |
![]() | COMPLETE : String = "complete" [statique] La constante Event.COMPLETE définit la valeur de la propriété type d'un objet événement complete. | Event | |
![]() | CONNECT : String = "connect" [statique] La constante Event.CONNECT définit la valeur de la propriété type d'un objet événement connect. | Event | |
![]() | COPY : String = "copy" [statique] Définit la valeur de la propriété type d'un objet d'événement copy. | Event | |
![]() | CUT : String = "cut" [statique] Définit la valeur de la propriété type d'un objet d'événement cut. | Event | |
![]() | DEACTIVATE : String = "deactivate" [statique] La constante Event.DEACTIVATE définit la valeur de la propriété type d'un objet événement deactivate. | Event | |
![]() | DISPLAYING : String = "displaying" [statique] La constante Event.DISPLAYING définit la valeur de la propriété type d'un objet événement displaying. | Event | |
![]() | ENTER_FRAME : String = "enterFrame" [statique] La constante Event.ENTER_FRAME définit la valeur de la propriété type d'un objet événement enterFrame. | Event | |
![]() | EXIT_FRAME : String = "exitFrame" [statique] La constante Event.EXIT_FRAME définit la valeur de la propriété type d'un objet événement exitFrame. | Event | |
![]() | [statique] La constante Event.EXITING définit la valeur de la propriété type de l'objet d'événement exiting. | Event | |
![]() | FRAME_CONSTRUCTED : String = "frameConstructed" [statique] La constante Event.FRAME_CONSTRUCTED définit la valeur de la propriété type d'un objet événement frameConstructed. | Event | |
![]() | FULLSCREEN : String = "fullScreen" [statique] La constante Event.FULL_SCREEN définit la valeur de la propriété type d'un objet événement fullScreen. | Event | |
![]() | [statique] La constante Event.HTML_BOUNDS_CHANGE définit la valeur de la propriété type d'un objet événement htmlBoundsChange. | Event | |
![]() | [statique] La constante Event.HTML_DOM_INITIALIZE définit la valeur de la propriété type d'un objet événement htmlDOMInitialize. | Event | |
![]() | [statique] La constante Event.HTML_RENDER définit la valeur de la propriété type d'un objet événement htmlRender. | Event | |
[statique] Contrairement à l'événement httpStatus, l'événement httpResponseStatus est renvoyé avant toute donnée de réponse. | HTTPStatusEvent | ||
| HTTP_STATUS : String = "httpStatus" [statique] La constante HTTPStatusEvent.HTTP_STATUS définit la valeur de la propriété type d'un objet événement httpStatus. | HTTPStatusEvent | ||
![]() | ID3 : String = "id3" [statique] La constante Event.ID3 définit la valeur de la propriété type d'un objet événement id3. | Event | |
![]() | INIT : String = "init" [statique] La constante Event.INIT définit la valeur de la propriété type d'un objet événement init. | Event | |
![]() | [statique] La constante Event.LOCATION_CHANGE définit la valeur de la propriété type d'un objet événement locationChange. | Event | |
![]() | MOUSE_LEAVE : String = "mouseLeave" [statique] La constante Event.MOUSE_LEAVE définit la valeur de la propriété type d'un objet événement mouseLeave. | Event | |
![]() | [statique] La constante Event.NETWORK_CHANGE définit la valeur de la propriété type d'un objet événement networkChange. | Event | |
![]() | OPEN : String = "open" [statique] La constante Event.OPEN définit la valeur de la propriété type d'un objet événement open. | Event | |
![]() | PASTE : String = "paste" [statique] La constante Event.PASTE définit la valeur de la propriété type d'un objet événement paste. | Event | |
![]() | REMOVED : String = "removed" [statique] La constante Event.REMOVED définit la valeur de la propriété type d'un objet événement removed. | Event | |
![]() | REMOVED_FROM_STAGE : String = "removedFromStage" [statique] La constante Event.REMOVED_FROM_STAGE définit la valeur de la propriété type d'un objet événement removedFromStage. | Event | |
![]() | RENDER : String = "render" [statique] La constante Event.RENDER définit la valeur de la propriété type d'un objet événement render. | Event | |
![]() | RESIZE : String = "resize" [statique] La constante Event.RESIZE définit la valeur de la propriété type d'un objet événement resize. | Event | |
![]() | SCROLL : String = "scroll" [statique] La constante Event.SCROLL définit la valeur de la propriété type d'un objet événement scroll. | Event | |
![]() | SELECT : String = "select" [statique] La constante Event.SELECT définit la valeur de la propriété type d'un objet événement select. | Event | |
![]() | SELECT_ALL : String = "selectAll" [statique] La constante Event.SELECT_ALL définit la valeur de la propriété type d'un objet événement selectAll. | Event | |
![]() | SOUND_COMPLETE : String = "soundComplete" [statique] La constante Event.SOUND_COMPLETE définit la valeur de la propriété type d'un objet événement soundComplete. | Event | |
![]() | TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [statique] La constante Event.TAB_CHILDREN_CHANGE définit la valeur de la propriété type d'un objet événement tabChildrenChange. | Event | |
![]() | TAB_ENABLED_CHANGE : String = "tabEnabledChange" [statique] La constante Event.TAB_ENABLED_CHANGE définit la valeur de la propriété type d'un objet événement tabEnabledChange. | Event | |
![]() | TAB_INDEX_CHANGE : String = "tabIndexChange" [statique] La constante Event.TAB_INDEX_CHANGE définit la valeur de la propriété type d'un objet événement tabIndexChange. | Event | |
![]() | UNLOAD : String = "unload" [statique] La constante Event.UNLOAD définit la valeur de la propriété type d'un objet événement unload. | Event | |
![]() | [statique] La constante Event.USER_IDLE définit la valeur de la propriété type d'un objet événement userIdle. | Event | |
![]() | [statique] La constante Event.USER_PRESENT définit la valeur de la propriété type d'un objet événement userPresent. | Event | |
| propriété |
responseHeaders:Array [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 |
Les en-têtes de réponse que la réponse a renvoyés, sous la forme d'un tableau d'objets URLRequestHeader.
public function get responseHeaders():Array public function set responseHeaders(value:Array):voidVoir aussi
| propriété |
responseURL:String [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 |
L'URL à partir de laquelle la réponse à été renvoyée. En cas de redirections, ceci sera différent de l'URL de requête.
public function get responseURL():String public function set responseURL(value:String):void| status | propriété |
status:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Le code d'état HTTP renvoyé par le serveur. Par exemple, une valeur 404 indique que le serveur n'a pas détecté de correspondance pour l'URL requise. Les valeurs de code HTTP sont répertoriées dans les sections 10.4 et 10.5 de la spécification HTTP à l'adresse ftp://ftp.isi.edu/in-notes/rfc2616.txt.
Si Flash Player ouAIR ne peut pas obtenir un code d'état auprès du serveur, ou s'il ne peut pas communiquer avec le serveur, la valeur 0 est transmise par défaut à votre code. Une valeur 0 peut être générée dans un lecteur quelconque (par exemple, si une URL mal formée est demandée), et une valeur 0 est toujours générée par le module Flash Player lorsqu'il est exécuté dans les navigateurs suivants, qui ne transmettent pas de codes d'état HTTP au lecteur : Netscape, Mozilla, Safari, Opera et Internet Explorer pour Macintosh.
public function get status():int| HTTPStatusEvent | () | Constructeur |
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Crée un objet Event contenant des informations sur les événements HTTPStatus. Les objets Event sont transmis en tant que paramètres aux écouteurs d'événements.
Paramètrestype:String —
Type de l'événement. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété type héritée. Il n'existe qu'un seul type d'événement HTTPStatus : HTTPStatusEvent.HTTP_STATUS.
| |
bubbles:Boolean (default = false) —
Détermine si l'objet Event prend part à la phase de propagation vers le haut (bubbling) du flux d'événements. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété bubbles héritée.
| |
cancelable:Boolean (default = false) —
Détermine si l'objet Event peut être annulé. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété cancelable héritée.
| |
status:int (default = 0) —
Etat numérique. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété status.
|
Voir aussi
| clone | () | méthode |
override public function clone():Event| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Crée une copie de l'objet HTTPStatusEvent et définit la valeur de chaque propriété de sorte qu'elle corresponde à la valeur d'origine.
Valeur renvoyéeEvent — Nouvel objet HTTPStatusEvent dont les propriétés ont la même valeur que celles de l'objet d'origine. |
| toString | () | méthode |
override public function toString():String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Renvoie une chaîne répertoriant toutes les propriétés de l'objet HTTPStatusEvent. La chaîne est écrite au format suivant :
[HTTPStatusEvent type=valeur bubbles=valeur cancelable=valeur status=valeur ]
String — Chaîne répertoriant toutes les propriétés de l'objet HTTPStatusEvent. |
| Constante |
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 |
Contrairement à l'événement httpStatus, l'événement httpResponseStatus est renvoyé avant toute donnée de réponse. De plus, l'événement httpResponseStatus inclut des valeurs pour les propriétés responseHeaders et responseURL (qui ne sont pas définies pour un événement httpStatus. Notez que httpResponseStatus (le cas échéant) est envoyé avant (et en complément de) tout événement complete ou error.
La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS définit la valeur de la propriété type d'un objet événement httpResponseStatus.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles
|
false
|
cancelable
|
false ; il n'existe aucun comportement par défaut à annuler.
|
currentTarget
| L'objet qui traite activement l'objet Event avec un écouteur d'événements. |
responseURL
| L'URL de laquelle la réponse a été renvoyée. |
responseHeaders
| Les en-têtes de réponse que la réponse a renvoyés, sous la forme d'un tableau d'objets URLRequestHeader. |
status
| Le code d'état HTTP renvoyé par le serveur. |
target
| L'objet réseau recevant un code d'état HTTP. |
Voir aussi
| HTTP_STATUS | Constante |
public static const HTTP_STATUS:String = "httpStatus"| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
La constante HTTPStatusEvent.HTTP_STATUS définit la valeur de la propriété type d'un objet événement httpStatus.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles
|
false
|
cancelable
|
false ; il n'existe aucun comportement par défaut à annuler.
|
currentTarget
| L'objet qui traite activement l'objet Event avec un écouteur d'événements. |
status
| Le code d'état HTTP renvoyé par le serveur. |
target
| L'objet réseau recevant un code d'état HTTP. |
Voir aussi
httpStatusHandler avec l'état 404, indiquant que le fichier est introuvable. L'événement httpStatusHandler est traité par httpStatusHandler(), qui imprime simplement deux lignes d'informations sur l'événement.
Remarques :
securityError dans cet exemple, vous devez compiler le fichier SWF en définissant « Sécurité de lecture locale » sur « Accès au réseau uniquement ».
httpStatusHandler avec le code d'état 0 au lieu de 404.
httpStatusHandler approprié.
package {
import flash.display.Sprite;
import flash.net.URLLoader;
import flash.net.URLRequest;
import flash.events.HTTPStatusEvent;
public class HTTPStatusEventExample extends Sprite {
public function HTTPStatusEventExample() {
var loader:URLLoader = new URLLoader();
loader.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
var request:URLRequest = new URLRequest("http://www.[yourDomain].com/MissingFile.html");
loader.load(request);
}
private function httpStatusHandler(event:HTTPStatusEvent):void {
trace("httpStatusHandler: " + event);
trace("status: " + event.status);
}
}
}