Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The quickest way to "test out" a PJS module to see how things work is to create it as a Express Route (web service), and call it using a browser.

In the following example, we'll create a web service to pass in a customer number = 1234, and get back the customer nameĀ  for that customer number.

  • Navigate to the workspace "pjstips".
  • Click New/Javascript File.
  • Enter the code below. Click Save As, and save as pjstips_02_1.js.

  • Code Block
    languagejs
    function app(req, res) {
      
      // When a PJS module is called as an Express Route (web service), two objects
      // are passed to the module.
      // 1. The "request" object, named as "req" here. You can use another name if you want.
      // 2. The "reponse" object, named as "res" here. You can use another name if you want.
    
      // Put this module in debug and call it from a browser. Then examine the "req" and "res" objects passed in, 
      // to see all the good stuff they contain.
    
      var custno = req.query.custno;          // input parm specified as query string paratemer, e.g. ?custno=1234
      var name = `Customer_name_${custno}`;   // get output customer name from input customer number
    
      // In this example, we'll use function res.send() to send back the "response" as a text message.
      
      res.send(`test from pjstips_02_1.js; custno = ${custno}; name = ${name}`);
    
    }
    
    exports.run = app;
    
    


  • In the Files tree, right-click on newly-created file pjstips_02_1.js, and click Properties. Mark the file as an Express Route, using HTTP method of "GET", with the Route Path as shown below.

...