Foutopsporing in JavaScript

Als u de taal JavaScript gebruikt voor een script, kunt u met de functie console.println("tekenreeks") informatie uitvoeren naar de JavaScript-console die beschikbaar is in Acrobat Professional. U kunt ook de methode alert van het JavaScript-objectmodel van Acrobat gebruiken voor het opsporen van fouten in JavaScript.

JavaScript-foutopsporing in Acrobat Professional

Met de JavaScript-foutopsporing in Acrobat Professional kunt u JavaScript-scripts testen. De foutopsporing bevat de JavaScript-console waarmee u gedeelten van JavaScript-code kunt testen op het tabblad Voorbeeld-PDF. De JavaScript-console biedt een interactieve en gemakkelijke interface voor het testen van gedeelten van JavaScript-code en het experimenteren met objecteigenschappen en methoden. Omdat de JavaScript-console interactief van aard is, werkt deze als een editor waarin u losse regels of blokken code kunt uitvoeren.

Als u JavaScript-foutopsporing wilt inschakelen voor Designer en code wilt uitvoeren vanuit de JavaScript-console, moet u JavaScript en JavaScript-foutopsporing inschakelen in Acrobat Professional.

Opmerking: U kunt de JavaScript-foutopsporing inschakelen in Adobe Reader als Adobe® LiveCycle® Reader® Extensions 10 is geïnstalleerd. Als u de JavaScript-foutopsporing wilt inschakelen in Adobe Reader, moet u het bestand debugger.js ophalen en vervolgens het register van Microsoft Windows bewerken. Zie Developing Acrobat Applications Using JavaScript voor meer informatie over het inschakelen van de JavaScript-foutopsporing in Adobe Reader (alleen Engelstalig).

JavaScript-foutopsporing inschakelen voor Designer

  1. Start Designer.

  2. Start Acrobat Professional.

  3. Selecteer in Acrobat Professional Bewerken > Voorkeuren.

  4. Selecteer JavaScript in de lijst aan de linkerkant.

  5. Selecteer Acrobat JavaScript inschakelen als deze optie nog niet is ingeschakeld.

  6. Selecteer JavaScript-foutopsporing inschakelen nadat Acrobat opnieuw is opgestart onder JavaScript-foutopsporing.

  7. Selecteer Interactieve console inschakelen. Met deze instelling kunt u code controleren die u in de JavaScript-console schrijft.

  8. Selecteer Console tonen bij fouten en berichten. Met deze instelling zorgt u ervoor dat als u fouten maakt, in de JavaScript-console nuttige informatie wordt weergegeven.

  9. Klik op OK om het venster Voorkeuren te sluiten.

  10. Sluit Acrobat Professional af.

  11. Klik in Designer op het tabblad Voorbeeld-PDF.

  12. Druk op Ctrl+J om JavaScript-foutopsporing te openen.

Voorkomen dat JavaScript-foutopsporing verdwijnt in Designer

Als de JavaScript-foutopsporing van Acrobat actief is en verdwijnt wanneer u op componenten in de Designer-interface klikt, moet u het proces Acrobat.exe beëindigen in het Taakbeheer van Windows. Het proces Acrobat.exe blijft actief nadat Acrobat is gesloten, zodat Acrobat sneller wordt weergegeven wanneer het opnieuw wordt gestart. Als u het proces beëindigt, verbreekt u de koppeling tussen JavaScript-foutopsporing en de Acrobat Professional-sessie, zodat u JavaScript-foutopsporing in Designer kunt gebruiken.

  1. Klik in Windows Taakbeheer op het tabblad Processen.

  2. Klik in de kolom Imagenaam met de rechtermuisknop op Acrobat.exe en klik op Proces beëindigen.

Code evalueren met de JavaScript-console

Er zijn drie manieren om één regel of meerdere regels met code te evalueren met de JavaScript-console van Acrobat.

Een gedeelte van een regel met code evalueren

 Markeer het gedeelte in het consolevenster en druk op Enter op het numerieke toetsenbord of op Ctrl+Enter op het gewone toetsenbord.

Eén regel met code evalueren

 Plaats de cursor in de juiste regel in het consolevenster en druk op Enter op het numerieke toetsenbord of op Ctrl+Enter op het gewone toetsenbord.

Meerdere regels met code evalueren

 Markeer de regels in het consolevenster en druk op Enter op het numerieke toetsenbord of op Ctrl+Enter op het gewone toetsenbord.

Inhoud in het JavaScript-console verwijderen

 Klik op Clear in het consolevenster.

Het resultaat van het als laatste geëvalueerde JavaScript wordt weergegeven in het consolevenster.

Na het evalueren van elke JavaScript-instructie wordt in het consolevenster undefined afgedrukt. Dit is het resultaat van de instructie. Het resultaat van een instructie is niet hetzelfde als de waarde van een expressie binnen de instructie. De retourwaarde undefined betekent niet dat de waarde van het script niet gedefinieerd is. Het betekent dat de retourwaarde van de JavaScript-instructie niet gedefinieerd is.

Feedback geven op foutopsporing met de JavaScript-console

Als u scripts maakt met JavaScript, kunt u bij het uitvoeren van het script berichten uitvoeren naar de JavaScript-console vanuit Acrobat met behulp van de methode console.println die deel uitmaakt van het JavaScript-objectmodel in Acrobat. Als de methode console.println wordt gestart, wordt een tekenreeks weergegeven in de JavaScript-console. De tekenreekswaarde kan een tekstbericht zijn dat u maakt voor foutopsporingsdoeleinden of de tekenreekswaarde van velden of expressies.

Stel dat u een eenvoudig formulierontwerp hebt met één numeriek veld (NumeriekVeld1) en één knop (Knop1). In dit geval wordt door het volgende JavaScript-script een bericht uitgevoerd met wat tekst en de waarde die momenteel in het numerieke veld wordt weergegeven. Als u de berekening of het script aan de click-gebeurtenis van het knopobject toevoegt, kunt u interactief de waarde van het numerieke veld in een nieuw dialoogvenster weergeven door op de knop te klikken.

    console.println("The value is: " + NumericField1.rawValue);

Zie Developing Acrobat Applications Using JavaScript voor meer informatie over de methode console.println en het JavaScript-objectmodel in Acrobat (alleen Engelstalig).

Zie Developing Acrobat Applications Using JavaScript voor meer informatie over de JavaScript-console en de JavaScript-foutopsporing (alleen Engelstalig).

Feedback geven op foutopsporing met de methode alert

Als u een berichtvenster wilt weergeven tijdens een calculate-gebeurtenis, kunt u gebruikmaken van de methode alert van het JavaScript-objectmodel in Acrobat. Met het volgende script wordt bijvoorbeeld de waarde van een tekstveld geretourneerd:

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

Zie Developing Acrobat Applications Using JavaScript voor meer informatie over de methode alert en het JavaScript-objectmodel in Acrobat (alleen Engelstalig).