| # Puppeteer |
| |
| [](https://github.com/puppeteer/puppeteer/actions/workflows/ci.yml) |
| [](https://npmjs.org/package/puppeteer) |
| |
| <img src="https://user-images.githubusercontent.com/10379601/29446482-04f7036a-841f-11e7-9872-91d1fc2ea683.png" height="200" align="right"/> |
| |
| > Puppeteer is a JavaScript library which provides a high-level API to control |
| > Chrome or Firefox over the |
| > [DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) or [WebDriver BiDi](https://pptr.dev/webdriver-bidi). |
| > Puppeteer runs in the headless (no visible UI) by default |
| |
| ## [Get started](https://pptr.dev/docs) | [API](https://pptr.dev/api) | [FAQ](https://pptr.dev/faq) | [Contributing](https://pptr.dev/contributing) | [Troubleshooting](https://pptr.dev/troubleshooting) |
| |
| ## Installation |
| |
| ```bash npm2yarn |
| npm i puppeteer # Downloads compatible Chrome during installation. |
| npm i puppeteer-core # Alternatively, install as a library, without downloading Chrome. |
| ``` |
| |
| ## Example |
| |
| ```ts |
| import puppeteer from 'puppeteer'; |
| // Or import puppeteer from 'puppeteer-core'; |
| |
| // Launch the browser and open a new blank page. |
| const browser = await puppeteer.launch(); |
| const page = await browser.newPage(); |
| |
| // Navigate the page to a URL. |
| await page.goto('https://developer.chrome.com/'); |
| |
| // Set screen size. |
| await page.setViewport({width: 1080, height: 1024}); |
| |
| // Open the search menu using the keyboard. |
| await page.keyboard.press('/'); |
| |
| // Type into search box using accessible input name. |
| await page.locator('::-p-aria(Search)').fill('automate beyond recorder'); |
| |
| // Wait and click on first result. |
| await page.locator('.devsite-result-item-link').click(); |
| |
| // Locate the full title with a unique string. |
| const textSelector = await page |
| .locator('::-p-text(Customize and automate)') |
| .waitHandle(); |
| const fullTitle = await textSelector?.evaluate(el => el.textContent); |
| |
| // Print the full title. |
| console.log('The title of this blog post is "%s".', fullTitle); |
| |
| await browser.close(); |
| ``` |
