Error.create 함수
업데이트: 2007년 11월
자세한 오류 정보를 포함할 수 있는 Error 개체를 만듭니다.
var err = Error.create(message, errorInfo);
인수
message
(선택적 요소) 오류 메시지 문자열입니다.errorInfo
(선택적 요소) 추가 오류 정보를 포함하는 JavaScript 개체의 인스턴스입니다. 이 개체에는 오류를 식별하는 문자열을 포함할 name 필드가 있어야 합니다. 또한 해당 오류를 자세히 설명하는 필드도 포함될 수 있습니다.
반환 값
Error 개체입니다.
설명
create 함수를 사용하면 자세한 오류 정보를 포함할 수 있는 Error 개체를 만들 수 있습니다. message 인수를 사용하면 오류가 발생할 경우 응용 프로그램에 표시할 수 있는 정보를 해당 오류에 연결하거나, 오류 추적을 위해 자세한 정보를 제공할 수 있습니다. 또한 errorInfo 인수를 사용하면 이 함수에서 만든 Error 개체에 오류 정보 필드를 추가할 수 있습니다. 이를 통해 해당 오류를 더 자세히 설명하는 사용자 지정 오류 정보를 지정할 수 있습니다. 제공하는 JavaScript 개체에는 오류를 식별하는 문자열을 포함할 name 필드가 있어야 합니다. errorInfo 개체에는 예외 처리를 사용자 지정하는 데 유용하도록 임의의 형식 및 이름을 사용하여 추가 필드를 제공할 수 있습니다.
예제
다음 예제에서는 create 함수를 사용하여 새 Error 개체를 만드는 방법을 보여 줍니다. 여기에서는 세 개의 오류가 만들어집니다. 첫 번째 오류는 Sys.ArgumentTypeException 예외입니다. 두 번째 오류는 message 인수에 전달된 메시지 문자열을 제공하고, 세 번째 오류는 오류 메시지 문자열 및 errorInfo 인수에 전달된 개체를 제공합니다. errorInfo 개체는 오류를 식별하는 필수 name 필드와 오류를 설명하는 추가 필드를 제공합니다.
function throwAnError(input)
{
if (input === undefined)
{
// Throw a standard exception type.
var err = Error.argumentNull("input", "A parameter was undefined.");
throw err;
}
else if (input === "Test1")
{
// Throw a generic error with a message.
var messageVar = "A test message.";
var err = Error.create(messageVar)
throw err;
}
else if (input === "Test2")
{
// Throw a generic error with a message and associated errorInfo object.
var messageVar = "This error contains an additional custom errorInfo object";
var errorInfoObj = { name: "SomeNamespace.SomeExceptionName", someErrorID: "436" };
var err = Error.create(messageVar, errorInfoObj);
throw err;
}
alert("No error occured.");
}
throwAnError("Test2");