SurveyJS Node.js Backend Integration with Express /

Load Choices from Web

MIT

Load Choices from Web

Load choice lists from APIs and update them when related answers change. For example, changing a region reloads the office list with matching options from your backend.

Documentation

Try this

  1. Select an Office, then change the Region. The previous office selection is cleared, and the backend supplies offices in the new region.
  2. Choose Your country from a separate list served by Node.js. The backend caches the list and uses bundled choices if the external service is unavailable.
  3. Press Complete to save your answers, then open Data to inspect the stored office ID and country code.
  4. Open Requests to inspect the office and country lookups, including the example authorization header.
  5. Press Start over to reset the form.

    No requests

      What the server stored
      JSON definition · shared/definitions/choices-from-web.json View on GitHub
      {
        "title": "Choose an office",
        "elements": [
          {
            "type": "panel",
            "name": "find_office",
            "elements": [
              {
                "type": "radiogroup",
                "name": "region",
                "title": "Region",
                "colCount": 3,
                "defaultValue": "europe",
                "isRequired": true,
                "choices": [
                  {
                    "value": "europe",
                    "text": "Europe"
                  },
                  {
                    "value": "americas",
                    "text": "Americas"
                  },
                  {
                    "value": "asia-pacific",
                    "text": "Asia-Pacific"
                  }
                ]
              },
              {
                "type": "dropdown",
                "name": "office",
                "title": "Office",
                "isRequired": true,
                "choicesByUrl": {
                  "url": "/api/offices?region={region}",
                  "valueName": "id",
                  "titleName": "name"
                }
              }
            ]
          },
          {
            "type": "dropdown",
            "name": "country",
            "title": "Your country",
            "isRequired": true,
            "choicesByUrl": {
              "url": "/api/countries",
              "valueName": "code",
              "titleName": "name"
            }
          }
        ]
      }
      Client · shared/client/choices-from-web.js · sjs:choices-from-web.client View on GitHub
      // Use choicesByUrl in the form definition to load lists from API endpoints
      //   "choicesByUrl": { "url": "/api/offices?region={region}", "valueName": "id", "titleName": "name" }
      //   "choicesByUrl": { "url": "/api/countries", "valueName": "code", "titleName": "name" }
      // SurveyJS replaces {region} with the selected region and reloads the office list when the region changes
      
      // Optional: add your auth header to every choices request
      import { settings } from "survey-core";
      settings.web.onBeforeRequestChoices = (_, options) => {
        options.request?.setRequestHeader("Authorization", `Bearer ${token}`);
      };
      Server · routes/choices-from-web.js · sjs:choices-from-web.server View on GitHub
      // GET /api/offices?region= — {region} from the form arrives as a query parameter
      app.get("/api/offices", (req, res) => {
        const region = typeof req.query.region === "string" ? req.query.region : "";   // ?region=a&region=b is an array
        res.json(db(req).prepare("SELECT id, name FROM offices WHERE region = ? ORDER BY name").all(region));
      });
      
      // GET /api/countries — a proxy: the browser can't call a service without CORS, your server can
      app.get("/api/countries", async (req, res) => {
        let countries = cache.get("countries");
        if (!countries) {
          try {
            const response = await fetchWithTimeout("https://restcountries.com/v3.1/all?fields=name,cca2", { timeout: 5000 });
            countries = (await response.json()).map((country) => ({ code: country.cca2, name: country.name.common }))
              .sort((a, b) => a.name.localeCompare(b.name));
            cache.set("countries", countries, DAY);
          } catch (error) {   // down, or a different answer: serve the bundled list for 10 minutes, not a timeout per request
            console.warn(`restcountries.com failed (${error.message}); serving shared/seed/countries.json`);
            countries = bundledCountries;
            cache.set("countries", countries, 10 * 60 * 1000);
          }
        }
        res.set("Cache-Control", "public, max-age=86400").json(countries);
      });