Google IDX Live icon

Google IDX Live

Google IDX Live
Join our community

Actions7

Overview

This node, named "Google IDX Live," interacts with Google IDX workspaces through browser automation using Puppeteer with stealth capabilities. It supports multiple operations including creating new workspaces, running commands in a workspace, checking live status, listing all workspaces, resetting workspaces, and running workspaces with optional screenshot capture.

A typical use case is automating management and interaction with Google IDX workspaces without manual browser intervention. For example, it can create a new workspace by navigating to the appropriate URL and entering the workspace name, or it can run commands inside a workspace's terminal interface. It also supports capturing screenshots of workspace states for visual verification.

Properties

Name Meaning
WorkSpace Name The name of the workspace to create or operate on. Required for "createWorkSpace" and "runCommand" operations.
Options Additional options for the operation:
- Browser WebSocket Endpoint A WebSocket endpoint URL to connect to an existing browser instance for Puppeteer automation.

Output

The node outputs JSON data describing the result of the performed operation, often including:

  • workspaces: An array of workspace objects (id, name, link, account) when listing or creating workspaces.
  • profile: The user profile associated with the API credentials.
  • status, lastSeen, hostnames, names, ips: Device status information when checking live status.
  • resetStatus, timeReset: Status and timestamp when resetting workspaces.
  • workspace, id, name, url, token, account: Details about a specific workspace when running or opening it.
  • screen or screenshot: Boolean indicating if a screenshot was captured.
  • Binary data containing a PNG screenshot image of the workspace or page state, useful for visual confirmation or logging.

If the operation involves screenshots, the node outputs binary data representing the PNG image(s).

Dependencies

  • Requires an API key credential for authenticating with Google IDX services.
  • Uses Puppeteer Extra with the Stealth plugin to automate Chromium-based browser interactions.
  • Optionally connects to an existing browser via a WebSocket endpoint if provided.
  • Network access to Google IDX URLs and related Google services.
  • Node environment must support Puppeteer and its dependencies.

Troubleshooting

  • Failed to launch/connect to browser: Ensure the WebSocket endpoint is correct and accessible, or that Puppeteer can launch a local browser instance.
  • No token given: The node requires valid API credentials with profile and cookie information; verify credentials are set up properly.
  • Timeouts or navigation failures: Network issues or changes in Google IDX web pages may cause selectors to fail; check network connectivity and update selectors if needed.
  • Screenshot capture errors: Errors like "detached Frame" or "Connection closed" indicate lost browser context; retrying or reconnecting the browser may help.
  • Operation-specific errors: For example, creating a workspace requires a valid workspace name; missing required parameters will cause errors.
  • If the node fails silently or returns empty results, verify that the authenticated user has access to the requested workspaces or permissions.

Links and References

Discussion