nome de propriedade
Retorna o nome de um erro.
errorObj.name
Argumentos
- errorObj
Obrigatório. Instância de Error objeto.
Comentários
O nome propriedade retorna o tipo de exceção ou o nome de um erro. Quando ocorre um erro de tempo de execução, a propriedade name é definida para um dos seguintes tipos de exceção nativo:
Tipo de exceção |
Significado |
|---|---|
Erro |
Esse erro é um erro definido pelo usuário, criado usando o Error construtor do objeto. |
ConversionError |
Este erro ocorre sempre que houver uma tentativa de converter um objeto em algo para o qual não pode ser convertido. |
RangeError |
Este erro ocorre quando uma função é fornecida com um argumento que excedeu o seu intervalo permitido. Por exemplo, este erro ocorre se você tentar construir um Array o objeto com um comprimento que não é um válido positivo inteiro. |
ReferenceError |
Este erro ocorre quando uma referência inválida foi detectada. Este erro ocorrerá, por exemplo, se uma referência esperada for null. |
RegExpError |
Este erro ocorre quando ocorre um erro de compilação com uma expressão regular. Depois que a expressão regular é compilada, no entanto, esse erro não pode ocorrer. Este exemplo ocorrerá, por exemplo, quando uma expressão regular é declarada com um padrão que tem uma sintaxe inválida ou sinalizadores diferente de i, g, ou m, ou se contiver o mesmo sinalizador mais de uma vez. |
SyntaxError |
Este erro ocorre quando o texto de origem é analisado e esse texto de origem não segue a sintaxe correta. Este erro ocorrerá, por exemplo, se o eval função é chamada com um argumento que é o texto do programa não é válido. |
TypeError |
Este erro ocorre sempre que o tipo real de um operando não corresponde ao tipo esperado. Um exemplo de quando este erro ocorre é uma chamada de função feita em algo que não é um objeto ou não oferece suporte a chamada. |
URIError |
Este erro ocorre quando um URI (Uniform Resource Indicator) ilegal é detectado. Por exemplo, este é o erro ocorre quando um caractere ilegal é encontrado em uma seqüência de caracteres que está sendo codificado ou decodificado. |
Exemplo
O exemplo a seguir faz com que uma exceção seja lançada e exibirá o erro e a descrição do erro.
try
{
var arr = new Array(-1);
}
catch(e)
{
print ("Error Message: " + e.message);
print ("Error Code: " + (e.number & 0xFFFF))
print ("Error Name: " + e.name);
}
A saída desse código é o seguinte.
Error Message: Array length must be zero or a positive integer
Error Code: 5029
Error Name: RangeError