# puppeteer-cn

> Puppeteer lives in China

Latest version **0.1.8** (published 2018-11-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install puppeteer-cn
pnpm add puppeteer-cn
yarn add puppeteer-cn
bun add puppeteer-cn
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.8 |
| Published | 2018-11-28 |
| First published | 2018-01-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=5.12.0 |
| Dependencies | 3 |
| Unpacked size | 12.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | yes |
| GitHub stars | 26 |
| Author | vk |
| Maintainers | valleykid |
| Keywords | puppeteer, cross-wall |

## Links

- npm: https://www.npmjs.com/package/puppeteer-cn
- Repository: https://github.com/valleykid/puppeteer-cn
- Homepage: https://github.com/valleykid/puppeteer-cn#readme
- Issues: https://github.com/valleykid/puppeteer-cn/issues
- npm.io page: https://npm.io/package/puppeteer-cn

## Dependencies (3)

- [is-wsl](https://npm.io/package/is-wsl.md) ^1.1.0
- [semver](https://npm.io/package/semver.md) ^5.5.0
- [shelljs](https://npm.io/package/shelljs.md) ^0.8.1

## Alternatives

- [@snazzah/davey](https://npm.io/package/@snazzah/davey.md) — 1.5M weekly downloads
- [@vendure/testing](https://npm.io/package/@vendure/testing.md) — 8.3K weekly downloads
- [vue-simple-context-menu](https://npm.io/package/vue-simple-context-menu.md) — 6.6K weekly downloads
- [cypress-webpack-preprocessor-v5](https://npm.io/package/cypress-webpack-preprocessor-v5.md) — 2.1K weekly downloads
- [@backstage/plugin-catalog-backend-module-puppetdb](https://npm.io/package/@backstage/plugin-catalog-backend-module-puppetdb.md) — 1.3K weekly downloads

## Recent versions

- 0.1.8 (latest) — 2018-11-28
- 0.1.9-alpha.1 — 2018-12-31
- 0.1.7 — 2018-02-11
- 0.1.6 — 2018-02-07
- 0.1.5 — 2018-02-07
- 0.1.4 — 2018-02-01
- 0.1.3 — 2018-01-31
- 0.1.2 — 2018-01-30
- 0.1.1 — 2018-01-30
- 0.1.0 — 2018-01-29

## README

# puppeteer-cn

> Puppeteer lives in China

As we know, the Google's servers are hard to access in China, But puppeteer relies on Chromium or Chrome59+. You can try `puppeteer-cn` if encounter the problem.

众所周知，天朝很难访问google的服务器，但是puppeteer又依赖Chromium/Chrome59+。如果遇到这个问题，你可以尝试下`puppeteer-cn`。

![](https://user-images.githubusercontent.com/1892857/35903942-2f382f34-0c1c-11e8-9855-15809b1a5985.png)

## Install

```bash
npm install puppeteer-cn --save
```

## Usage

Same as [puppeteer](https://github.com/GoogleChrome/puppeteer), you can replace `puppeteer` with `puppeteer-cn`. But it first checks your local Chrome version is greater than 59, then decides whether to install Chromium by a fast mirror.

和[puppeteer](https://github.com/GoogleChrome/puppeteer)完全一样，你完全可以用`puppeteer-cn`代替之。这个包会先去检测本地Chrome版本是否大于59，再决定是否通过一个国内源下载Chromium。

```javascript
const puppeteer = require('puppeteer-cn');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('https://example.com');
  await page.screenshot({path: 'example.png'});

  await browser.close();
})();
```

If you use `puppeteer/DeviceDescriptors` in some scenarios, you can do that:

某些场景下如果需要使用`puppeteer/DeviceDescriptors`，你可以这样做：

```javascript
const puppeteer = require('puppeteer-cn');
const devices = require('puppeteer-cn/devices');
const iPhone = devices['iPhone 6'];

puppeteer.launch().then(async browser => {
  const page = await browser.newPage();
  await page.emulate(iPhone);
  await page.goto('https://www.google.com');
  // other actions...
  await browser.close();
});
```

## License

MIT

---
_Source: https://npm.io/package/puppeteer-cn · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._