Função erro.criar
Cria um Erro objeto que pode conter informações adicionais sobre o erro.
var err = Error.create(message, errorInfo);
Argumentos
message
(Opcional) Uma seqüência de mensagem de erro.errorInfo
(Opcional) Uma instância de um objeto JavaScript que contém informações estendidas sobre o erro. O objeto deve ter um name campo que contém uma seqüência de caracteres que identifica o erro. O objeto também pode conter campos para descrever o erro totalmente.
Valor de retorno
Um objeto Error.
Comentários
Use o create função para criar um Error objeto que pode conter informações adicionais sobre o erro. The message argumento permite que você anexar informações como o erro que pode ser exibido em um aplicativo quando ocorre o erro ou para fornecer detalhes para rastrear erros. The errorInfo argumento permite que você adicione informações de erro sistema autônomo campos para o Error objeto criado pela função. Isso lhe permite especificar informações de erro personalizada que descreve totalmente o erro. O objeto JavaScript que você fornecer deve ter um campo chamado name que contém uma seqüência de caracteres que identifica o erro. Você pode fornecer campos adicionais de qualquer tipo e nome no errorInfo objeto, que é útil para a manipulação de exceção personalizado.
Exemplo
O exemplo a seguir mostra como criar um novo Error objeto usando o create função. Três erros são criados. O primeiro erro é um Sys.ArgumentTypeException exceção. O segundo erro fornece uma seqüência de mensagem que é passada no message argumento. O terceiro erro fornece uma seqüência de caracteres da mensagem de erro e um objeto que é passado no errorInfo argumento. The errorInfo objeto fornece o necessário name campo que identifica o erro e um campo adicional que descreve o erro.
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");
Consulte também
Conceitos
Visão geral de Depuração e Rastreamento de Aplicativos AJAX