n8n-nodes-webdriverio

This is an n8n community node that provides integration with WebdriverIO for browser and mobile automation.

n8n is a fair-code licensed workflow automation platform.

WebdriverIO is an automation framework for browser and mobile testing.

Features

This node allows you to:

• Execute WebdriverIO commands for browser and mobile automation
• Configure automated workflows within n8n's interface
• Support dynamic WebdriverIO configurations including:
  • Platform settings (Android, iOS)
  • Appium settings (host, port, automation name)
  • Device capabilities
  • App-specific parameters (package name, activity)
  • Custom WebdriverIO options

Prerequisites

• Node.js v18+
• n8n v1.0+
• Running Appium server for mobile automation

Installation

Follow these steps to install this node in your n8n instance:

# Install from NPM
npm install n8n-nodes-webdriverio

# Install from source
cd ~/.n8n/custom
git clone https://github.com/yourusername/n8n-nodes-webdriverio.git
cd n8n-nodes-webdriverio
npm install
npm run build

Restart your n8n instance and the WebdriverIO node should be available.

Usage

Credentials

Before using the WebdriverIO node, you need to configure WebdriverIO API credentials:

1. Create new credentials of type "WebdriverIO API"
2. Configure the Appium server, automation name, and log level
3. Save the credentials

Node Operations

The WebdriverIO node supports three main operations:

1. Start Session: Initializes a new WebdriverIO session with specified capabilities

   • Configure platform (Android/iOS)
   • Set device name
   • Configure app-specific settings (app package, activity, bundle ID)

2. Execute Action: Perform various automation actions

   • Click Element
   • Set Value
   • Get Text
   • Find Element
   • Wait For Element
   • Execute Custom Command

3. End Session: Terminates the active WebdriverIO session

Example Workflow

A basic workflow for mobile automation might include:

1. Start Session node: Initialize WebdriverIO with Android settings
2. Execute Action node: Click on a specific element
3. Execute Action node: Enter text into an input field
4. Execute Action node: Verify text on screen
5. End Session node: Clean up the WebdriverIO session

Development

To develop and modify this node:

# Clone the repository
git clone https://github.com/yourusername/n8n-nodes-webdriverio.git

# Install dependencies
cd n8n-nodes-webdriverio
npm install

# Build
npm run build

# Link to your n8n installation
npm link
cd ~/.n8n
npm link n8n-nodes-webdriverio

License

MIT