Oggetto Error

Articolo
09/12/2008

Aggiornamento: novembre 2007

Contiene informazioni relative agli errori. Esistono due forme del costruttore Error.

function Error([description : String ])
function Error([number : Number [, description : String ]])

Argomenti

number
Facoltativo. Valore numerico assegnato all'errore che specifica il valore della proprietà number. Se omesso, il valore è zero.
description
Facoltativo. Breve stringa che descrive l'errore e specifica il valore iniziale delle proprietà description e message. Se omessa, corrisponde a una stringa vuota.

Note

Gli oggetti Error possono essere creati in modo esplicito mediante il costruttore descritto sopra. È possibile aggiungere proprietà all'oggetto Error per espanderne le funzionalità. Inoltre, ogni volta che si verifica un errore di runtime viene creato un oggetto Error per descrivere l'errore.

In genere, un oggetto Error viene generato mediante l'istruzione throw e si prevede che venga intercettato mediante un'istruzione try...catch. È possibile utilizzare un'istruzione throw per passare qualsiasi tipo di dati come errore. L'istruzione throw non creerà in modo implicito un oggetto Error. Tuttavia, generando un oggetto Error, un blocco catch può considerare gli errori di runtime JScript e gli errori definiti dall'utente in modo simile.

L'oggetto Error dispone di quattro proprietà intrinseche relative alla descrizione dell'errore (proprietà description e message), al numero dell'errore (proprietà number) e al nome dell'errore (proprietà name). Le proprietà description e message si riferiscono allo stesso messaggio, con la differenza che la prima garantisce la compatibilità con le versioni precedenti mentre la seconda è conforme allo standard ECMA.

Un numero di errore è un valore a 32 bit. Il valore a 16 bit di livello superiore è il codice del servizio, mentre il valore di livello inferiore rappresenta il codice effettivo dell'errore. Per leggere il codice di errore effettivo, utilizzare l'operatore & (AND bit per bit) per combinare la proprietà del numero con il numero esadecimale 0xFFFF.

Attenzione:
Se si tenta di utilizzare l'oggetto Error di JScript in una pagina ASP.NET potrebbero verificarsi risultati imprevisti. Ciò è dovuto alla potenziale ambiguità tra l'oggetto Error di JScript e l'evento Error della pagina ASP.NET. Utilizzare la classe System.Exception anziché l'oggetto Error per la gestione degli errori nelle pagine ASP.NET.

Nota:
L'oggetto Error è disponibile solo in JScript. Poiché tale oggetto non deriva da un tipo .NET Framework, non è possibile utilizzarlo con altri linguaggi compatibili con CLS (Common Language Specification). Per tale motivo, durante l'annotazione del tipo di parametri e tipi restituiti dei metodi compatibili con CLS, assicurarsi di utilizzare il tipo di dati System.Exception anziché l'oggetto Error. È possibile tuttavia utilizzare l'oggetto Error per l'annotazione del tipo di identificatori diversi dai parametri o dai tipi restituiti. Per ulteriori informazioni, vedere Scrittura di codice compatibile con CLS.

L'oggetto Error è disponibile solo in JScript. Poiché tale oggetto non deriva da un tipo .NET Framework, non è possibile utilizzarlo con altri linguaggi compatibili con CLS (Common Language Specification). Per tale motivo, durante l'annotazione del tipo di parametri e tipi restituiti dei metodi compatibili con CLS, assicurarsi di utilizzare il tipo di dati System.Exception anziché l'oggetto Error. È possibile tuttavia utilizzare l'oggetto Error per l'annotazione del tipo di identificatori diversi dai parametri o dai tipi restituiti. Per ulteriori informazioni, vedere Scrittura di codice compatibile con CLS.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo dell'oggetto Error.

try {
   // Throw an error.
   throw new Error(42,"No question");
} catch(e) {
   print(e)
// Extract the error code from the error number.
   print(e.number & 0xFFFF)
   print(e.description)
}

L'output del codice è il seguente: