mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
---
|
|
hide_table_of_contents: true
|
|
---
|
|
|
|
# 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 Node.js 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
|
|
> but can be configured to run in a visible ("headful") browser.
|
|
|
|
## [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});
|
|
|
|
// Type into search box.
|
|
await page.type('.devsite-search-field', 'automate beyond recorder');
|
|
|
|
// Wait and click on first result.
|
|
const searchResultSelector = '.devsite-result-item-link';
|
|
await page.waitForSelector(searchResultSelector);
|
|
await page.click(searchResultSelector);
|
|
|
|
// Locate the full title with a unique string.
|
|
const textSelector = await page.waitForSelector('text/Customize and automate');
|
|
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();
|
|
```
|