Depuración de JavaScript

Depurador de JavaScript en Acrobat Professional

El depurador de JavaScript en Acrobat Professional permite probar las secuencias de comandos de JavaScript. El depurador incluye la consola de JavaScript, donde puede probar las distintas partes del código de JavaScript en la ficha Vista previa del PDF. La consola de JavaScript proporciona una interfaz conveniente e interactiva para probar partes del código de JavaScript y experimentar con métodos y propiedades de objetos. Debido a su naturaleza interactiva, la consola de JavaScript se comporta como un editor que permite la ejecución de líneas independientes o de bloques de código.

Para activar el depurador de JavaScript para Designer y ejecutar el código desde la consola de JavaScript, debe activar JavaScript y el depurador de JavaScript en Acrobat Professional.

Activar el depurador de JavaScript para Designer

1. Inicie Designer.

2. Inicie Acrobat Professional.

3. En Acrobat Professional, seleccione Editar > Preferencias.

4. Seleccione JavaScript en la lista de la izquierda.

5. Seleccione Activar JavaScript para Acrobat si no está seleccionado.

6. En el depurador de JavaScript, seleccione Activar el depurador de JavaScript después de reiniciar Acrobat.

7. Seleccione Activar la consola interactiva. Esta opción permite evaluar el código que se escribe en la consola de JavaScript.

8. Seleccione Mostrar la consola si se generan errores y mensajes. Con esta opción se consigue que, siempre que se comentan errores, la consola de JavaScript muestre información de utilidad.

9. Haga clic en Aceptar para cerrar el cuadro de diálogo Preferencias.

10. Salga de Acrobat Professional.

11. En Designer, haga clic en la ficha Vista previa de PDF.

12. Pulse Ctrl+J para abrir el depurador de JavaScript.

Evitar que el depurador de JavaScript desaparezca en Designer

Si el depurador de JavaScript de Acrobat está activo y desaparece cuando se hace clic en los componentes de la interfaz de Designer, se debe detener el proceso Acrobat.exe en el Administrador de tareas de Microsoft Windows. El proceso Acrobat.exe continúa ejecutándose después de cerrar Acrobat para que Acrobat se abra más rápido si se reinicia. Al detener el proceso, se termina la asociación entre el depurador de JavaScript y la sesión de Acrobat Professional, por lo que se puede utilizar el depurador de JavaScript en Designer.

1. En el Administrador de tareas de Windows, haga clic en la ficha Procesos.

2. En la columna Nombre de imagen, haga clic con el botón derecho del ratón en Acrobat.exe y seleccione Finalizar proceso.

Evaluación del código usando la consola de JavaScript

Existen tres formas de evaluar líneas únicas y múltiples de código usando la consola de JavaScript desde Acrobat.

Evaluar una parte de una línea de código

 Resalte esa parte en la ventana de la consola y pulse la tecla Intro del teclado numérico o pulse Ctrl+Intro en el teclado normal.

Evaluar una línea única de código

 Coloque el cursor en la línea correspondiente de la ventana de la consola y pulse la tecla Intro del teclado numérico o pulse Ctrl+Intro en el teclado normal.

Evaluar varias líneas de código

 Resalte esas líneas en la ventana de la consola y pulse la tecla Intro del teclado numérico o pulse Ctrl+Intro en el teclado normal.

Eliminar el contenido que aparece en la consola de JavaScript

 Haga clic en Borrar en la ventana de la consola.

Se muestra en la ventana de la consola el resultado de la secuencia de comandos de JavaScript evaluada más recientemente.

Después de que se ejecute cada instrucción de JavaScript, la ventana de la consola imprime undefined, que es el valor que devuelve la instrucción. Tenga en cuenta que el resultado de una instrucción no es lo mismo que el valor de una expresión dentro de la instrucción. El resultado undefined devuelto no significa que el valor de la secuencia de comandos sea undefined (sin definir), sino que el valor devuelto de la instrucción de JavaScript es undefined.

Proporcionar información de depuración a la consola de JavaScript

Si va a crear secuencias de comandos utilizando JavaScript, puede enviar mensajes a la consola de JavaScript desde Acrobat durante la ejecución con el método console.println incluido en el Modelo de objetos JavaScript de Acrobat. Cuando se inicia, el método console.println muestra un valor de cadena en la consola de JavaScript. El valor de cadena puede ser un mensaje de texto que se cree con fines de depuración o el valor de cadena de campos o expresiones.

Por ejemplo, imaginemos un diseño de formulario sencillo que incluye un único campo numérico (NumericField1) y un botón (Button1). En esa situación, la secuencia de comandos de JavaScript siguiente muestra un mensaje que incluye texto y el valor mostrado actualmente en el campo numérico. Si se agrega el cálculo o la secuencia de comandos al suceso click del objeto de botón, se puede mostrar de forma interactiva el valor del campo numérico en un cuadro de diálogo nuevo haciendo clic en el botón.

    console.println("El valor es: " + NumericField1.rawValue);

Para obtener más información acerca del método console.println y el Modelo de objetos JavaScript de Acrobat, consulte Developing Acrobat Applications Using JavaScript (solo en inglés).

Para obtener más información acerca de la consola de JavaScript y el depurador de JavaScript, consulte Developing Acrobat Applications Using JavaScript (solo en inglés).

Información de depuración mediante el método alert

Si se quiere mostrar un cuadro de mensaje durante un suceso calculate, se puede utilizar el método alert del Modelo de objetos JavaScript en Acrobat. Por ejemplo, la siguiente secuencia de comandos devuelve el valor de un campo de texto:

    var oField = xfa.resolveNode("TextField1").rawValue; app.alert(oField);

Para obtener más información acerca del método alert y el Modelo de objetos JavaScript de Acrobat, consulte Developing Acrobat Applications Using JavaScript (solo en inglés).