@debug (Directiva)
Activa o desactiva la emisión de símbolos de depuración.
@set @debug(on | off)
Argumentos
on
Valor predeterminado. Palabra clave que activa la depuración.off
Opcional. Palabra clave que desactiva la depuración.
Comentarios
El código de programa que escribe un autor de JScript difiere a veces del código real que se compila y ejecuta. Los entornos host, como ASP.NET, o las herramientas de desarrollo pueden generar su propio código y agregarlo al programa. Este código no suele tener interés para el autor durante la depuración. Por tanto, cuando depuran su código, los autores sólo desean ver las partes del programa que escribieron sin partes generadas por las herramientas de desarrollo. Es posible que los autores de paquetes deseen desactivar la depuración por motivos similares.
El compilador emite símbolos de depuración solo cuando se compila desde la línea de comandos con la opción /debug o cuando se compila una página ASP.NET con la marca de depuración establecida en la directiva @page. En estas circunstancias, la directiva debug está activada de manera predeterminada. Cuando aparece una directiva debug, permanece efectiva hasta que se llega al final del archivo o hasta que se encuentra la siguiente directiva debug.
Cuando la directiva debug está desactivada, el compilador no emite información de depuración para las variables locales (variables definidas en funciones o métodos). Sin embargo, la directiva debug no impide la emisión de la información de depuración para variables globales.
Ejemplo
El código siguiente emite símbolos de depuración para la variable local debugOnVar, pero no para debugOffVar, cuando se compila desde la línea de comandos con la opción /debug:
function debugDemo() {
// Turn debugging information off for debugOffVar.
@set @debug(off)
var debugOffVar = 42;
// Turn debugging information on.
@set @debug(on)
// debugOnVar has debugging information.
var debugOnVar = 10;
// Launch the debugger.
debugger;
}
// Call the demo.
debugDemo();