Skip to main content
Version: v2.0.0

Use Inspector

In this how-to guide, we will take a look at Inspector of the app-builder and see how it can be helpful in building applications.

The Inspector can be used to inspect the data of the queries, properties and values of the components that are there on the canvas, ToolJet's global variables and the variables that have been set by the user.

How to - Use Inspector

Layout

Let's take a look at the layout of the Inspector panel:

  • On the top-right, we have a Pin button to pin and unpin the inspector panel. This button can be useful when you want to see the live changes on inspector while triggering a query or performing some event/action on any component.

    How to - Use Inspector
  • At the bottom right, you can click and hold to resize the inspector.

    How to - Use Inspector
  • On hovering an item on the inspector, the copy path and copy value buttons will appear on the right of the item. Copying the path and pasting it onto the component property or query parameter will always get the dynamic value but using Copy value uption will copy the current value of the item and will be static when pasted in a component property or query parameter.

    How to - Use Inspector

Sections

The Inspector panel has the following 4 main sections:

queries

The queries section can be used to inspect the query details but the data of the query will only be available if query has been run/triggered.

tip

You can click on the Preview button of the button on the query manager to check the response(data) of the query without triggering it.

Example

  • Let's create a new query using a mock REST API endpoint (https://fakestoreapi.com/products).

  • Now go to the Inspector and expand the queries section, you'll see an entry inside queries with the query name that we created in the previous step i.e. restapi1 but if you notice the data and rawData object is empty i.e. 0 entry. The reason is the data won't show up on the inspector unless query is run.

    How to - Use Inspector
  • Let's pin the inspector and then trigger the query from the query manager. You'll see that as soon as the query is triggered the rawData and data object in the query has 20 entries and the query has more properties like request, response, and responseHeaders data.

    How to - Use Inspector

components

components section can be used to inspect the properties and values of the components that are added onto the canvas.

How to - Use Inspector

globals

globals section includes the following sub-sections:

  • currentUser: The currentUser object contains information about the currently logged-in user such as email, firstName, and lastName.
  • groups: The groups array contains the name of the groups the currently logged-in user is added to. Note: The all_users is default groups for everyone.
  • theme: The theme object contains the name of the currently active theme.
  • urlparam: The urlparams contains the information about the url parameters of the application.
info

All the global variables can be accessed anywhere inside the ToolJet applications. Here's an example use-case of using these variables.

How to - Use Inspector

variables

variables section include all the variables set by the user in the application. These variables can be set from the event handlers from the components or from the queries. The variables will be in the key-value pair and can be accessed throughout the application.

info