playwright/docs/README.md

# Documentation

### Capabilities

Playwright is a library to automate [Chromium](https://www.chromium.org/Home), [Firefox](https://www.mozilla.org/en-US/firefox/new/) and [WebKit](https://webkit.org/) with a single API. Playwright is built to enable cross-browser web automation that is **ever-green**, **capable**, **reliable** and **fast**.

* Ever-green browser engines
* Headless execution
* Scenarios that span multiple pages, domains and iframes
* Auto-wait for elements to be ready before executing actions (like click, fill)
* Reliable signals instead of timeouts (like network response, popup, navigation)
* Intercept network activity for stubbing and mocking network requests
* Emulate mobile devices, geolocation, permissions
* Support for web components via shadow-piercing selectors
* Native input events for mouse and keyboard
* Upload and download files

### Table of contents

1. Introduction
    - [Why Playwright?](./why-playwright.md)
    - [Get started](./intro.md)
    - [Core concepts](./core-concepts.md)
    - [Debugging](./debug.md)
    - [Supported languages](./languages.md)
1. Guides
    - [Selectors](./selectors.md)
    - [Input](./input.md)
    - [Emulation](./emulation.md)
    - [Network](./network.md)
    - [Assertions](./assertions.md)
    - [Verification](./verification.md)
    - [Navigations](./navigations.md)
    - [Multi-page scenarios](./multi-pages.md)
1. Tutorials
    - [Authentication](./auth.md)
    - [Page object models](./pom.md)
1. Integrations
    - [Test runners](./test-runners.md)
    - [Docker](./docker/README.md)
    - [Continuous integration](./ci.md)
1. Reference
    - [API Reference](./api.md)
    - [Actionability](./actionability.md)
    - [Advanced installation](./installation.md)
    - [Extensibility](./extensibility.md)
1. Get help
    - [Slack community](https://join.slack.com/t/playwright/shared_invite/enQtOTEyMTUxMzgxMjIwLThjMDUxZmIyNTRiMTJjNjIyMzdmZDA3MTQxZWUwZTFjZjQwNGYxZGM5MzRmNzZlMWI5ZWUyOTkzMjE5Njg1NDg)
    - [Stack Overflow](https://stackoverflow.com/tags/playwright)
    - [GitHub](https://github.com/microsoft/playwright/issues)
docs(readme): update readme and intro docs (#1963) 2020-04-24 22:19:31 +03:00			`# Documentation`

docs: update docs (#3253) - Make docs/README.md more prominent, include capabilities - Link to examples from specific topics 2020-07-31 21:58:12 +03:00			`### Capabilities`

			`Playwright is a library to automate [Chromium](https://www.chromium.org/Home), [Firefox](https://www.mozilla.org/en-US/firefox/new/) and [WebKit](https://webkit.org/) with a single API. Playwright is built to enable cross-browser web automation that is ever-green, capable, reliable and fast.`

			`* Ever-green browser engines`
			`* Headless execution`
			`* Scenarios that span multiple pages, domains and iframes`
			`* Auto-wait for elements to be ready before executing actions (like click, fill)`
			`* Reliable signals instead of timeouts (like network response, popup, navigation)`
			`* Intercept network activity for stubbing and mocking network requests`
			`* Emulate mobile devices, geolocation, permissions`
			`* Support for web components via shadow-piercing selectors`
			`* Native input events for mouse and keyboard`
			`* Upload and download files`

docs(input): include clicks and files sections (#1868) 2020-04-20 04:47:36 +03:00			`### Table of contents`

docs: update table of contents for docs sidebar (#3291) 2020-08-05 01:48:32 +03:00			`1. Introduction`
docs: introduce why-playwright.md (#3666) 2020-08-28 19:38:12 +03:00			`- [Why Playwright?](./why-playwright.md)`
docs(intro): add cli to getting started (#3821) * docs(intro): add cli to getting started * fix doclint 2020-09-10 03:32:49 +03:00			`- [Get started](./intro.md)`
docs: update table of contents for docs sidebar (#3291) 2020-08-05 01:48:32 +03:00			`- [Core concepts](./core-concepts.md)`
			`- [Debugging](./debug.md)`
docs: add page on language bindings (#3819) 2020-09-10 03:33:10 +03:00			`- [Supported languages](./languages.md)`
docs: update table of contents for docs sidebar (#3291) 2020-08-05 01:48:32 +03:00			`1. Guides`
			`- [Selectors](./selectors.md)`
			`- [Input](./input.md)`
			`- [Emulation](./emulation.md)`
			`- [Network](./network.md)`
			`- [Assertions](./assertions.md)`
			`- [Verification](./verification.md)`
docs: update navigation and loading page (#3655) * docs: update navigation and loading doc * dgozman comments * doclint 2020-08-28 03:47:23 +03:00			`- [Navigations](./navigations.md)`
docs: update table of contents for docs sidebar (#3291) 2020-08-05 01:48:32 +03:00			`- [Multi-page scenarios](./multi-pages.md)`
docs: introduce docs for page object models (#3391) 2020-08-12 01:46:36 +03:00			`1. Tutorials`
docs: introduce doc on authentication (#3404) 2020-08-13 02:02:23 +03:00			`- [Authentication](./auth.md)`
docs: introduce docs for page object models (#3391) 2020-08-12 01:46:36 +03:00			`- [Page object models](./pom.md)`
docs: update table of contents for docs sidebar (#3291) 2020-08-05 01:48:32 +03:00			`1. Integrations`
			`- [Test runners](./test-runners.md)`
			`- [Docker](./docker/README.md)`
			`- [Continuous integration](./ci.md)`
			`1. Reference`
			`- [API Reference](./api.md)`
			`- [Actionability](./actionability.md)`
			`- [Advanced installation](./installation.md)`
			`- [Extensibility](./extensibility.md)`
docs: add help section (#3741) 2020-09-04 02:57:22 +03:00			`1. Get help`
			`- [Slack community](https://join.slack.com/t/playwright/shared_invite/enQtOTEyMTUxMzgxMjIwLThjMDUxZmIyNTRiMTJjNjIyMzdmZDA3MTQxZWUwZTFjZjQwNGYxZGM5MzRmNzZlMWI5ZWUyOTkzMjE5Njg1NDg)`
			`- [Stack Overflow](https://stackoverflow.com/tags/playwright)`
			`- [GitHub](https://github.com/microsoft/playwright/issues)`