ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.events 

UncaughtErrorEvents  - AS3

Paketflash.events
Klassepublic class UncaughtErrorEvents
VererbungUncaughtErrorEvents Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2

Die UncaughtErrorEvents-Klasse bietet eine Möglichkeit, Ereignisse für nicht erfasste Fehler zu empfangen. Eine Instanz dieser Klasse setzt ein uncaughtError-Ereignis ab, wenn ein Laufzeitfehler auftritt und der Fehler in Ihrem Code nicht erfasst und verarbeitet wird.

Mit den folgenden Eigenschaften können Sie auf eine UncaughtErrorEvents-Instanz zugreifen:

  • LoaderInfo.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in derselben SWF-Datei definiert ist.
  • Loader.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in der SWF-Datei definiert ist, die von einem Loader-Objekt geladen wird.

Um einen Fehler direkt abzufangen und ein nicht erfasstes Fehlerereignis zu verhindern, gehen Sie folgendermaßen vor:

  • Verwenden Sie einen try..catch -Block, um Code zu isolieren, der möglicherweise einen synchronen Fehler ausgibt.
  • Wenn Sie einen Vorgang ausführen, der beim Auftreten eines Fehlers ein Ereignis absetzt, registrieren Sie einen Listener für dieses Fehlerereignis.

Wenn es sich bei dem von einem Loader-Objekt geladenen Inhalt um eine AVM1 (ActionScript 2)-SWF-Datei handelt, führen nicht erfasste Fehler in der AVM1-SWF-Datei nicht zu einem uncaughtError-Ereignis. Außerdem führen JavaScript-Fehler in HTML-Inhalten, die in ein HTMLLoader-Objekt (einschließlich eines Flex-HTML-Steuerungselements) geladen werden, nicht zu einem uncaughtError-Ereignis.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
Erstellt eine UncaughtErrorEvents-Instanz.
UncaughtErrorEvents
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
  Wird abgesetzt, wenn ein Fehler auftritt und der Entwicklercode den Fehler nicht erkennt und verarbeitet.UncaughtErrorEvents
Konstruktordetails

UncaughtErrorEvents

()Konstruktor
public function UncaughtErrorEvents()

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2

Erstellt eine UncaughtErrorEvents-Instanz. Entwickler sollten UncaughtErrorEvents-Instanzen nicht direkt erstellen. Um auf ein UncaughtErrorEvents-Objekt zuzugreifen, verwenden Sie eine der folgenden Eigenschaften:

  • LoaderInfo.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in derselben SWF-Datei definiert ist.
  • Loader.uncaughtErrorEvents: zum Erkennen nicht erfasster Fehler im Code, der in der SWF-Datei definiert ist, die von einem Loader-Objekt geladen wird.

Verwandte API-Elemente

Ereignisdetails

uncaughtError

Ereignis
Ereignisobjekttyp: flash.events.UncaughtErrorEvent
Eigenschaft UncaughtErrorEvent.type = flash.events.UncaughtErrorEvent.UNCAUGHT_ERROR

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10.1, AIR 2

Wird abgesetzt, wenn ein Fehler auftritt und der Entwicklercode den Fehler nicht erkennt und verarbeitet.

Definiert den Wert der type-Eigenschaft eines uncaughtError-Ereignisobjekts.

Hinweis: Wenn Sie in einem Versuchsblock sind, gibt es einen Ereignisverteiler, der seinen Ereignishandler aufruft. Der Erfassungsblock erfasst den Fehler nicht, wenn er in einem Ereignishandler auftritt. Jeder Fehler, der anschließend ausgegeben wird, kann von LoaderInfo.uncaughtErrorEvents erfasst werden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelabletrue; das Abbrechen des Ereignisses verhindert, dass das Dialogfeld für nicht erfasste Fehler in Debugger-Versionen der Laufzeitumgebung angezeigt wird
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
errorDer nicht erfasste Fehler.
targetDas LoaderInfo-Objekt, das mit der SWF-Datei verknüpft ist, in der der Fehler aufgetreten ist.
textTextfehlermeldung.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.