Skip to content

digitalchild/n8n-playwright-scripts

 
 

Repository files navigation

n8n-nodes-playwright-scripts

This is an n8n community node. It lets you automate browser actions using Playwright in your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation

Operations

Compatibility

Resources

Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-playwright-scripts

Note: The package will automatically download and set up the required browser binaries during installation. This requires approximately 1GB of disk space.

If you need to manually trigger the browser setup:

npm rebuild n8n-nodes-playwright-scripts

Operations

This node supports the following operations:

  • Navigate: Go to a specified URL
  • Take Screenshot: Capture a screenshot of a webpage
  • Get Text: Extract text from an element using CSS selector
  • Click Element: Click on an element using CSS selector
  • Fill Form: Fill a form field using CSS selector
  • Run Playwright Script: Paste and execute custom Playwright scripts directly in the node. This allows advanced browser automation by providing your own JavaScript code, with direct access to the Playwright page object.

Run Playwright Script Usage

  • Operation: Run Playwright Script
  • Parameters:
    • URL: The initial page to open (required)
    • Playwright Script: Paste your custom Playwright JavaScript code here. The page object is available for scripting (required).

Example Script:

// Example: Fill a search box and submit
await page.fill('input[name="q"]', 'n8n');
await page.keyboard.press('Enter');
await page.waitForTimeout(2000);

Output:

  • success: true if the script ran without error, false otherwise
  • content: HTML content of the page after script execution
  • url: The current URL after script execution
  • error: Error message if the script failed

This operation is ideal for advanced automation, custom flows, or when you need to perform actions not covered by the basic operations.

Browser Options

  • Choose between Chromium, Firefox, or WebKit
  • Configure headless mode
  • Adjust operation speed with slow motion option

Screenshot Options

  • Full page capture
  • Custom save path
  • Base64 output

Compatibility

  • Requires n8n version 1.0.0 or later
  • Tested with Playwright version 1.49.0
  • Supports Windows, macOS, and Linux

System Requirements

  • Node.js 18.10 or later
  • Approximately 1GB disk space for browser binaries
  • Additional system dependencies may be required for browser automation

Resources

Version history

0.1.0

  • Initial release
  • Basic browser automation operations
  • Support for Chromium, Firefox, and WebKit.
  • Screenshot and form interaction capabilities

0.1.13

  • Add support for running Playwright scripts

Troubleshooting

If browsers are not installed correctly:

  1. Clean the installation:
rm -rf ~/.cache/ms-playwright
# or for Windows:
rmdir /s /q %USERPROFILE%\AppData\Local\ms-playwright
  1. Rebuild the package:
npm rebuild n8n-nodes-playwright-scripts

License

MIT

About

n8n-community-node-package for browser automation using Playwright with script support

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 85.6%
  • JavaScript 14.4%