Adobe® Flash® Platform용 ActionScript® 3.0 참조 설명서
 |  패키지 및 클래스 목록 숨기기 |  패키지  |  클래스  |  새로운 내용  |  색인  |  부록  |  영어로 표시되는 이유
필터: 서버에서 데이터를 검색하는 중...
서버에서 데이터를 검색하는 중...
최상위 레벨 

Error  - AS3

패키지최상위 레벨
클래스public dynamic class Error
상속Error Inheritance Object
하위 클래스 ArgumentError, AugmentedError, AutomationError, CollectionViewError, ComplexCyclicDependencyError, Conflict, ConstraintError, CursorError, DataServiceError, DefinitionError, DRMManagerError, EvalError, ExpressionError, ExpressionEvaluationError, ExpressionValidationError, Fault, FormBridgeError, FunctionSequenceError, IllegalOperationError, InvalidCategoryError, InvalidFilterError, InvalidSWFError, IOError, ItemPendingError, MediaError, MemoryError, MessagingError, MetricError, NoDataAvailableError, PermissionError, PersistenceError, PersistenceError, ProxyServiceError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, SimpleCyclicDependencyError, SortError, SQLError, StackOverflowError, SyncManagerError, SyntaxError, TypeError, UnresolvedConflictsError, URIError, VerifyError, VideoError, VideoError

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

Error 클래스에는 스크립트에서 발생한 오류에 대한 정보가 들어 있습니다. ActionScript 3.0 응용 프로그램을 개발할 때 디버거 버전의 Flash 런타임에서 컴파일된 코드를 실행하면 Error 유형 또는 하위 클래스의 예외가 대화 상자에 표시되며 이를 통해 코드 문제를 쉽게 해결할 수 있습니다. Error 객체를 만들려면 Error 생성자 함수를 사용합니다. 일반적으로는 try 코드 블록 내에서 catch 코드 블록에서 catch되는 새 Error 객체를 throw합니다.

Error 클래스의 하위 클래스를 만들고 해당 하위 클래스의 인스턴스를 throw할 수도 있습니다.

예제 보기



공용 속성
 속성정의 주체
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  errorID : int
[읽기 전용] 특정 오류 메시지와 연관된 참조 번호가 포함되어 있습니다.
Error
  message : String
Error 객체에 연결된 메시지가 들어 있습니다.
Error
  name : String
Error 객체의 이름이 들어 있습니다.
Error
공용 메서드
 메서드정의 주체
  
Error(message:String = "", id:int = 0)
새 Error 객체를 만듭니다.
Error
  
오류의 구조가 문자열인 경우 오류에 대해 호출 스택을 반환합니다.
Error
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.
Object
  
[재정의] 기본적으로 "Error"라는 문자열을 반환하며, Error.message 속성이 정의되어 있는 경우에는 여기에 포함된 값을 반환합니다.
Error
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
속성 세부 정보

errorID

속성
errorID:int  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

특정 오류 메시지와 연관된 참조 번호가 포함되어 있습니다. 사용자 정의 Error 객체의 경우 이 번호는 생성자에 지정된 id 매개 변수의 값입니다.



구현
    public function get errorID():int

message

속성 
public var message:String

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

Error 객체에 연결된 메시지가 들어 있습니다. 기본적으로 이 속성의 값은 "Error"입니다. Error 객체를 만들 때 Error 생성자 함수에 오류 문자열을 전달하여 message 속성을 지정할 수 있습니다.

관련 API 요소

name

속성 
public var name:String

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

Error 객체의 이름이 들어 있습니다. 기본적으로 이 속성의 값은 "Error"입니다.

관련 API 요소

생성자 세부 정보

Error

()생성자
public function Error(message:String = "", id:int = 0)

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

새 Error 객체를 만듭니다. message를 지정하면 해당 값이 객체의 Error.message 속성에 할당됩니다.

매개 변수
message:String (default = "") — Error 객체에 연결된 문자열이며, 이 매개 변수는 선택 요소입니다.
 
id:int (default = 0) — 지정된 오류 메시지에 연결할 참조 번호입니다.

관련 API 요소


예제  ( 예제 사용 방법 )

다음 예제에서는 새 Error 객체 err를 만든 다음 Error() 생성자를 사용하여 "New Error Message"라는 문자열을 err에 할당합니다.
var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message
메서드 세부 정보

getStackTrace

()메서드
public function getStackTrace():String

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

오류의 구조가 문자열인 경우 오류에 대해 호출 스택을 반환합니다. 아래 예제에서 알 수 있듯이 반환 값의 첫 번째 줄은 예외 객체의 문자열 표현이며 그 뒤로 스택 추적 요소가 이어집니다.

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()[/src/com/xyz/OrderEntry.as:995]
         at com.xyz::OrderEntry/init()[/src/com/xyz/OrderEntry.as:200]
         at com.xyz::OrderEntry()[/src/com/xyz/OrderEntry.as:148]
        

앞의 목록에서는 코드가 디버거 버전의 Flash Player 또는 AIR Debug Launcher(ADL)에서 실행될 때 이 메서드의 값을 보여 줍니다. 코드가 릴리스 버전의 Flash Player 또는 AIR에서 실행되는 경우 스택 추적은 다음 예제에서처럼 파일 경로 및 줄 번호 정보 없이 제공됩니다.

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()
         at com.xyz::OrderEntry/init()
         at com.xyz::OrderEntry()
        

Flash Player 11.4 이하 및 AIR 3.4 이하의 경우 스택 추적은 코드가 디버거 버전의 Flash Player 또는 AIR Debug Launcher(ADL)에서 실행되는 경우에만 사용할 수 있습니다. 이러한 런타임의 비디버거 버전에서 이러한 메서드를 호출하면 null이 반환됩니다.

반환값
String — 호출 스택의 문자열 표현입니다.

toString

()메서드 
override public function toString():String

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0, Flash Player 9, Flash Lite 4

기본적으로 "Error"라는 문자열을 반환하며, Error.message 속성이 정의되어 있는 경우에는 여기에 포함된 값을 반환합니다.

반환값
String — 오류 메시지입니다.

관련 API 요소


예제  ( 예제 사용 방법 )

다음 예제에서는 새 Error 객체 err를 만든 다음 Error() 생성자를 사용하여 "New Error Message"라는 문자열을 err에 할당합니다. 마지막으로, message 속성을 "Another New Error Message"로 설정하여 "New Error Message"를 덮어씁니다.
var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message

err.message = "Another New Error Message";
trace(err.toString());    // Error: Another New Error Message
ErrorExample.as

다음 예제에서는 ErrorExample 클래스를 사용하여 사용자 정의 오류를 발생시키는 방법을 보여 줍니다. 이는 다음 단계로 이루어집니다.
  1. Array 유형의 로컬 변수 nullArray를 선언합니다. 이때 새 Array 객체가 만들어지는 것은 아닙니다.
  2. 생성자에서 초기화되지 않은 배열로 값을 로드하려고 시도합니다. 이때 오류 처리 코드 세그먼트 내에서 push() 메서드를 사용하며, 이 오류 처리 코드는 Error를 확장하는 CustomError 클래스를 사용하여 사용자 정의 오류를 catch합니다.
  3. CustomError가 throw되면 생성자는 이를 catch한 다음 trace() 문을 사용하여 오류 메시지를 출력합니다.
package
{
    import flash.display.Sprite;
    public class ErrorExample extends Sprite 
    {
        private var nullArray:Array;
        public function ErrorExample() 
        {
            try 
            {
                nullArray.push("item");
            }
            catch(e:Error) 
            {
                throw new CustomError("nullArray is null");
            }
        }
    }
}

class CustomError extends Error 
{
    public function CustomError(message:String) 
    {
        super(message);
    }
}




[ X ]영어로 표시되는 이유
ActionScript 3.0 참조 설명서의 내용이 영어로 나타납니다.

ActionScript 3.0 참조 설명서 중 일부는 전체 언어로 번역되지 않았습니다. 언어 요소가 번역되지 않은 경우 영어로 나타납니다. 예를 들어 ga.controls.HelpBox 클래스는 어떤 언어로도 번역되지 않았습니다. 그러므로 한국어 버전의 참조 설명서에서 ga.controls.HelpBox 클래스는 영어로 나타납니다.