언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Error
생성자 함수를 사용합니다. 일반적으로는 try
코드 블록 내에서 catch
코드 블록에서 catch되는 새 Error 객체를 throw합니다.
Error 클래스의 하위 클래스를 만들고 해당 하위 클래스의 인스턴스를 throw할 수도 있습니다.
속성 | 정의 주체 | ||
---|---|---|---|
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
errorID : int [읽기 전용]
특정 오류 메시지와 연관된 참조 번호가 포함되어 있습니다. | Error | ||
message : String
Error 객체에 연결된 메시지가 들어 있습니다. | Error | ||
name : String
Error 객체의 이름이 들어 있습니다. | Error |
메서드 | 정의 주체 | ||
---|---|---|---|
새 Error 객체를 만듭니다. | Error | ||
오류의 구조가 문자열인 경우 오류에 대해 호출 스택을 반환합니다. | Error | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
[재정의]
기본적으로 "Error"라는 문자열을 반환하며, Error.message 속성이 정의되어 있는 경우에는 여기에 포함된 값을 반환합니다. | Error | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object |
errorID | 속성 |
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 요소
예제 ( 예제 사용 방법 )
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 요소
예제 ( 예제 사용 방법 )
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
클래스를 사용하여 사용자 정의 오류를 발생시키는 방법을 보여 줍니다. 이는 다음 단계로 이루어집니다.
- Array 유형의 로컬 변수
nullArray
를 선언합니다. 이때 새 Array 객체가 만들어지는 것은 아닙니다. - 생성자에서 초기화되지 않은 배열로 값을 로드하려고 시도합니다. 이때 오류 처리 코드 세그먼트 내에서
push()
메서드를 사용하며, 이 오류 처리 코드는Error
를 확장하는CustomError
클래스를 사용하여 사용자 정의 오류를 catch합니다. - 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); } }
Tue Jun 12 2018, 03:17 PM Z