playwright

package module
v0.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 1, 2024 License: Apache-2.0 Imports: 9 Imported by: 0

README

ℹ️

This is not supported by the k6 team, and is worked on by a(n) individual contributor(s). It may also break in the future as both xk6 and playwright-go evolve. Any issues with the tool should be raised here.

It is not production ready yet, but definitely works as intended! Please enjoy the tool!



xk6-playwright

xk6 playwright


k6 extension that adds support for browser automation and end-to-end web testing using playwright-go

Special thanks to all the contributors over at k6 and playwright-go

Here's to open source!

GitHub license Go Report Card GitHub license




Origin Story

This project was inspired by xk6-browser. Having previously worked with playwright-go we thought it would be a great idea to create an alternative extension around browser automation for the k6 community. Thus xk6 playwright was born!

Note

Although xk6-browser is still experimental it is pretty awesome and now comes bundled with k6 v0.46.0 and greater! In case this doesn't fit all your needs, go check that out!


Build the executable

To build a k6 binary with this extension, first ensure you have the prerequisites:

  • Docker

Then:

  1. Build the binary:
docker run --rm -e GOOS=darwin -u "$(id -u):$(id -g)" -v "${PWD}:/xk6" \
grafana/xk6 build \
--with github.com/wosp-io/xk6-playwright

on Windows:

docker run --rm -e GOOS=windows -u "$(id -u):$(id -g)" -v "${PWD}:/xk6" `

grafana/xk6 build --output k6.exe `
--with github.com/wosp-io/xk6-playwright

This will create a k6 binary file in the current working directory. This file can be used exactly the same as the main k6 binary, with the addition of being able to run xk6-playwright scripts.

  1. For the tool to work, the browsers and OS dependencies must be installed locally. You can use the following command for this:
go run github.com/playwright-community/playwright-go/cmd/playwright@v0.2000.1  install --with-deps
  1. Run scripts that import k6/x/playwright with the new k6 binary. On Linux and macOS make sure this is done by referencing the file in the current directory, e.g. ./k6 run <script>, or you can place it somewhere in your PATH so that it can be run from anywhere on your system.

Simplest Working Example

import pw from 'k6/x/playwright';

export default function () {
  try {
    pw.launch();
    pw.newPage();
    pw.goto('https://test.k6.io/my_messages.php', { waitUntil: 'networkidle' });
    pw.waitForSelector("input[name='login']", { state: 'visible' });
  } catch (err) {
    console.log(err);
  } finally {
    pw.kill();
  }
}

Simplest Headful Example

import pw from 'k6/x/playwright';

export default function () {
  try {
    pw.launch({ headless: false });
    pw.newPage();
    pw.goto('https://test.k6.io/my_messages.php', { waitUntil: 'networkidle' });
    pw.waitForSelector("input[name='login']", { state: 'visible' });
  } catch (err) {
    console.log(err);
  } finally {
    pw.kill();
  }
}

Monitor Real User Metrics

import pw from 'k6/x/playwright';

export default function () {
  try {
    pw.launch()
    pw.newPage()
    pw.goto('https://test.k6.io/my_messages.php', { waitUntil: 'networkidle' });
    pw.waitForSelector("input[name='login']", { state: 'visible' });
    pw.type("input[name='login']", "admin")
    pw.sleep(500)//give a chance for the browser apis to catch up 

    //print out real user metrics of the google search page
    console.log(`First Paint: ${pw.firstPaint()}ms`)
    console.log(`First Contentful Paint: ${pw.firstContentfulPaint()}ms`)
    console.log(`Time to Minimally Interactive: ${pw.timeToMinimallyInteractive()}ms`)
    console.log(`First Input Delay: ${pw.firstInputDelay()}ms`)
  } catch (err) {
    console.log(err);
  } finally {
    pw.kill();
  }
}

Examples

More example can be found in the ./examples directory


Currently Supported Actions

Playwright API coverage is as follows:

Action Encompassed Playwright Function(s) Description
launch() Run() & Launch() starts playwright client and launches Chromium browser
connect() Run() & Connect() attaches playwright client to existing browser instance
newPage() NewPage() opens up a new page within the browser
goto() Goto() navigates to a specified url
waitForSelector() WaitForSelector() waits for an element to be on the page based on the provided selector
click() Click() clicks an element on the page based on the provided selector
type() Type() types in an 'input' element on the page based on the provided selector and string to be entered
pressKey() PressKey() simulates pressing a key, types in an 'input' element on the page based on a key to be entered
sleep() Sleep() waits for a specified amount of time in milliseconds
screenshot() Screenshot() attempts to take and save a png image of the current screen
focus() Focus() focuses a spcific element based on the provided selector
fill() Fill() fills an 'input' element on the page based on the provided selector and string to be entered
selectOptions() SelectOption() selects an 'input' element from a list or dropdown of options on the page based on the provided selector and values to be selected
check() Check() checks an element on the page based on the provided selector
uncheck() Uncheck() unchecks an element on the page based on the provided selector
dragAndDrop() DragAndDrop() drag an item from one place to another based on two selectors
evaluate() Evaluate() evaluate an expresion or function and get the return value
reload() Reload() reloads the current page
cookies() Cookies() get all the cookies available for the default browser context.
firstPaint() N/A this function is unique to xk6-playwright What is First Paint? captures the first paint metric of the current page milliseconds
firstContentfulPaint() N/A this function is unique to xk6-playwright What is First Contentful Paint? captures the first contentful paint metric of the current page milliseconds
timeToMinimallyInteractive() N/A this function is unique to xk6-playwright - This is based on the first input registerd on the current page - NOTE: this is how we personally like to determine when a page is minimally interactive. captures the time to minimally interactive metric of the current page milliseconds
firstInputDelay() N/A this function is unique to xk6-playwright What is First Input Delay? captures the first input delay metric of the current page in milliseconds

The above 'Encompassed Playwright Function(s)' will link to the playwright-go package documentation to give an in-depth overview of how these functions will behave from a low-level perspective.

If you would like a high-level perspective on how these actions work you will be better served with the Playwright API Documentation


Contributing

  1. Fork it (https://github.com/your-github-user/xk6-playwright/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

Nick Vuono - creator and maintainer

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Playwright

type Playwright struct {
	Self           *playwright.Playwright
	Browser        playwright.Browser
	BrowserContext playwright.BrowserContext
	Page           playwright.Page
}

Playwright is the k6 extension for a playwright-go client.

func (*Playwright) Check

func (p *Playwright) Check(selector string, opts playwright.LocatorCheckOptions)

Check wrapper around playwright check page function that takes in a selector and a set of options

func (*Playwright) Click

func (p *Playwright) Click(selector string, opts playwright.PageClickOptions)

Click wrapper around playwright click page function that takes in a selector and a set of options

func (*Playwright) Connect

func (p *Playwright) Connect(url string, args playwright.BrowserTypeConnectOverCDPOptions)

Connect attaches Playwright to an existing browser instance

func (*Playwright) Cookies

func (p *Playwright) Cookies() []playwright.Cookie

Cookies wrapper around playwright cookies fetch function

func (*Playwright) DragAndDrop

func (p *Playwright) DragAndDrop(sourceSelector string, targetSelector string, opts playwright.PageDragAndDropOptions)

DragAndDrop wrapper around playwright draganddrop page function that takes in two selectors(source and target) and a set of options

func (*Playwright) Evaluate

func (p *Playwright) Evaluate(expression string, opts interface{}) interface{}

Evaluate wrapper around playwright evaluate page function that takes in an expresion and a set of options and evaluates the expression/function returning the resulting information.

func (*Playwright) Fill

func (p *Playwright) Fill(selector string, filledString string, opts playwright.LocatorFillOptions)

Fill wrapper around playwright fill page function that takes in a selector, text, and a set of options

func (*Playwright) FirstContentfulPaint

func (p *Playwright) FirstContentfulPaint() uint64

FirstContentfulPaint function that gathers the Real User Monitoring Metrics for First Contentful Paint of the current page

func (*Playwright) FirstInputDelay

func (p *Playwright) FirstInputDelay() uint64

FirstInputDelay function that gathers the Real User Monitoring Metrics for First Input Delay of the current page

func (*Playwright) FirstPaint

func (p *Playwright) FirstPaint() uint64

FirstPaint function that gathers the Real User Monitoring Metrics for First Paint of the current page

func (*Playwright) Focus

func (p *Playwright) Focus(selector string, opts playwright.PageFocusOptions)

Focus wrapper around playwright focus page function that takes in a selector and a set of options

func (*Playwright) Goto

func (p *Playwright) Goto(url string, opts playwright.PageGotoOptions)

Goto wrapper around playwright goto page function that takes in a url and a set of options

func (*Playwright) Kill

func (p *Playwright) Kill()

Kill closes browser instance and stops puppeteer client

func (*Playwright) Launch

func (p *Playwright) Launch(args playwright.BrowserTypeLaunchOptions)

Launch starts the playwright client and launches a browser

func (*Playwright) LaunchPersistent

func (p *Playwright) LaunchPersistent(dir string, args playwright.BrowserTypeLaunchPersistentContextOptions)

LaunchPersistent starts the playwright client and launches a browser with a persistent context

func (*Playwright) NewPage

func (p *Playwright) NewPage()

NewPage opens a new page within the browser

func (*Playwright) PressKey

func (p *Playwright) PressKey(selector string, key string, opts playwright.PagePressOptions)

PressKey wrapper around playwright Press page function that takes in a selector, key, and a set of options

func (*Playwright) Reload

func (p *Playwright) Reload()

Reload wrapper around playwright reload page function

func (*Playwright) Screenshot

func (p *Playwright) Screenshot(filename string, perm fs.FileMode, opts playwright.PageScreenshotOptions)

Screenshot wrapper around playwright screenshot page function that attempts to take and save a png image of the current screen.

func (*Playwright) SelectOptions

func (p *Playwright) SelectOptions(selector string, values playwright.SelectOptionValues, opts playwright.LocatorSelectOptionOptions)

SelectOptions wrapper around playwright selectOptions page function that takes in a selector, values, and a set of options

func (*Playwright) Sleep

func (p *Playwright) Sleep(time float64)

Sleep wrapper around playwright waitForTimeout page function that sleeps for the given `timeout` in milliseconds

func (*Playwright) TimeToMinimallyInteractive

func (p *Playwright) TimeToMinimallyInteractive() uint64

TimeToMinimallyInteractive function that gathers the Real User Monitoring Metrics for Time to Minimally Interactive of the current page (based on the first input)

func (*Playwright) Type

func (p *Playwright) Type(selector string, typedString string, opts playwright.PageTypeOptions)

Type wrapper around playwright type page function that takes in a selector, string, and a set of options

func (*Playwright) Uncheck

func (p *Playwright) Uncheck(selector string, opts playwright.LocatorUncheckOptions)

Uncheck wrapper around playwright uncheck page function that takes in a selector and a set of options

func (*Playwright) WaitForSelector

func (p *Playwright) WaitForSelector(selector string, opts playwright.PageWaitForSelectorOptions)

WaitForSelector wrapper around playwright waitForSelector page function that takes in a selector and a set of options

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL