Block reference

This page describes every block type available in the Maskifi scenario builder. Blocks are the individual steps that make up a scenario.

All string fields in any block support variable interpolation — insert {{variableName}} anywhere a string is accepted and Maskifi substitutes the value at run time. See Variables & secrets for the full syntax.

Action

The most versatile block. The Action field determines what the browser does. All action blocks share a common set of optional parameters:

Supports {{variableName}} in Selector, Value, and other text fields.

Click

Standard left click on the matched element.

Use: Submit forms, open links, toggle checkboxes.

Human click

Same as Click but uses humanised cursor movement when the profile's browser is launched with that option enabled.

Use: Clicking where natural mouse movement is needed to reduce bot-detection signals.

Double click

Double left-click on the matched element.

Use: Edit inline text, select a word, open files.

Right click

Right-click (context menu) on the matched element.

Use: Open context menus, trigger custom right-click handlers.

Type

Clicks the element, then types text character by character with human-like delays and occasional typos. Clears any existing content first.

Use: Fill forms, search boxes, login credentials.

Navigate

Navigate the active tab to a URL.

Waits for the page to load before proceeding.

Use: Open pages, follow links programmatically.

Scroll

Scroll an element into view, or scroll the page by a fixed pixel amount.

Use: Reach lazy-loaded content, scroll to specific elements.

Hover

Move the mouse pointer over the matched element.

Use: Open dropdown menus, trigger tooltips, reveal hidden elements.

Press

Press a keyboard key, optionally focused on an element.

Common key names: Enter, Escape, Tab, ArrowDown, ArrowUp, Backspace, Delete, Control+A, Shift+Tab.

Use: Submit with Enter, close modals, keyboard navigation.

Wait

Wait for an element to become visible before continuing.

Use: Wait for content that loads after the page, animations, page transitions.

Select

Select an option in a dropdown.

Use: Form dropdowns, filter selectors.

Mouse move

Move the mouse to a specific position on the page.

Use: Simulate human mouse movement, interact with canvas elements.

Upload

Upload a file via a file input element.

Use: Upload avatars, documents, import files.

Drag and drop

Drag one element to another.

Use: Kanban boards, sortable lists, file drop zones.

New tab

Open a new browser tab, optionally navigating to a URL.

After this block runs, subsequent blocks operate in the new tab.

Use: Open links in new tabs, parallel page work.

Switch tab

Switch to an existing tab by its number (first tab = 1).

Use: Return to the original tab after working in a new one.

Close tab

Close a tab by its number, or the current tab if no number is given.

After closing, execution continues in the first remaining tab.

Use: Clean up tabs after extracting data.

Switch iframe

Move focus into an embedded iframe on the page, or back to the main page.

After switching, all actions operate inside the iframe until you switch back.

Use: Payment forms, embedded widgets, third-party iframes.

Close browser

Close the browser for the current profile. Any blocks after this are skipped.

No parameters.

Use: Final clean-up step at the end of a scenario.

Delay

Pause execution for a random duration between a minimum and maximum.

Use: Simulate human-like pauses between actions, wait for animations to finish.

Extract

Extract data from the page and store it in a named variable for use in later blocks.

Text

Reads the visible text content of the matched element.

Attribute

Reads a specific HTML attribute from the element (for example href, src).

Count

Counts how many elements match the selector and stores the number.

Use: Get text from elements, read link targets, count items for loop conditions.

API

Make an HTTP request and store the response in a variable.

The response is stored as a JSON object. Access nested fields in later blocks: {{responseVariable.data.id}}.

Use: Send webhooks, fetch external data, integrate with third-party APIs.

Condition

Execute one set of blocks if a condition is true, and optionally a different set if it is false.

You define a condition by choosing a left value, an operator, and a right value. Supported operators: equals, not equals, greater than, less than, greater than or equal, less than or equal, contains (checks whether one value appears inside another), and exists (checks whether a variable has a value at all).

The "If true" branch runs when the condition passes; the optional "If false" branch runs when it does not.

Use: Conditional navigation, error handling, different paths based on page state.

Loop

Repeat a set of blocks a fixed number of times or while a condition remains true.

Inside the loop body, {{$index}} holds the current iteration number (starting at 0).

Use: Pagination scraping, clicking "load more" N times, repeating a step while a condition holds.

Script

Execute arbitrary JavaScript in the page and optionally store the return value.

The script runs inside the browser page. You can use {{variableName}} inside the code. Return a value to store it in the result variable.

return document.querySelectorAll('.product').length

return JSON.parse(localStorage.getItem('userData'))?.token

Use: Complex page interactions, reading page storage, custom calculations.

Try/Catch

Wrap blocks in an error handler. If any block in the "Try" section fails, execution continues with the "Catch" section instead of stopping the scenario.

Without a Try/Catch block, any block failure stops the entire scenario immediately. Wrapping risky steps in Try/Catch lets the scenario handle errors gracefully.

Use: Handle optional popups (cookie banners, modals) that may or may not appear, graceful error recovery, retry patterns.

Log

Output a message to the execution log. Supports {{variableName}} interpolation.

Messages appear in the execution log panel during and after a run.

Processing item {{$index}} of {{totalItems}}
Extracted email: {{userEmail}}
API response: {{apiResponse.status}}

Use: Debug scenarios, track progress, log extracted values.

AI Agent

Run an AI agent that autonomously operates the browser to achieve a stated goal.

Use: Open-ended browser tasks where the exact steps are not known in advance.

Generate

Generate a new identity for the active profile (name, locale, age).

Use: Generating realistic persona data before a registration flow.

Variable interpolation reference

All text fields accept {{...}} expressions: