Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 14 Next »

You can debug Profound.js modules on your local machine.

The first step is to install Profound.js onto your local machine by using 'npm install profoundjs'. Click here for more detailed installation instructions.

This guide will show you how to debug an application. The example application used here is the same application generated in the Generating Profound.js Modules with JumpStart guide.

 

Step 1 - Setup

First, copy the source that you'd like to debug (and dependencies for that source) from your IBM i onto your local machine.

For example, if your Profound.js module was stored in /profoundjs/modules/demolib/prodapp.js on your IBM i, then you would copy it to /profoundjs/modules/demolib/prodapp.js on your local machine.

If you have to copy a Profound.js module into a directory that does not exist on your local machine yet, do not forget to add it to your pathlist in your Profound.js server settings.

 

Step 2 - Test

Once you have copied the source to your local machine, you should test that your IBM i can reach your local machine.

  1. In a Genie session, use command PJSMYIP. This changes your session to point to your local Profound.js server. For more details, click here.
  2. Now, start your local Profound.js server. To do this, change your current directory to your Profound.js installation directory and use 'node start.js' to start the Profound.js server.
  3. Lastly, call your program from Genie: CALL PRODAPP. This will redirect the call to your local Profound.js server, where the JavaScript is run.

 

Step 3 - VS Code Debug Setup

For VS Code, you will want to open your Profound.js directory as your workspace. This is so it's easy to navigate and debug through existing source.

You will also want to create a new debug configuration, which would look like this:

        {
            "name": "Launch",
            "type": "node",
            "request": "launch",
            "program": "${workspaceRoot}/start.js",
            "stopOnEntry": false,
            "args": [],
            "cwd": "${workspaceRoot}",
            "runtimeArgs": [
                "--nolazy"
            ],
            "env": {
                "NODE_ENV": "development"
            },
            "console": "internalConsole",
            "sourceMaps": false
        }

This specifies that when you start debugging, it will launch the Profound.js inside of your VS Code instance. This allows you to put breakpoints into Profound.js modules.

To test this debug configuration is working, when you start debugging you should see the following in your 'DEBUG CONSOLE':

To debug our application, open the file in VS Code and set a break point. To test, we will set one at the Profound.js module entry point.

  • No labels