# puppeteer-extra-plugin-user-preferences

> Launch puppeteer with arbitrary user preferences.

Latest version **2.4.1** (published 2023-03-01) · MIT license · 0 weekly downloads

## Install

```sh
npm install puppeteer-extra-plugin-user-preferences
pnpm add puppeteer-extra-plugin-user-preferences
yarn add puppeteer-extra-plugin-user-preferences
bun add puppeteer-extra-plugin-user-preferences
```

## Health

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

Positive: no vulnerabilities.

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

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.4.1 |
| Published | 2023-03-01 |
| First published | 2018-05-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=8 |
| Dependencies | 4 |
| Unpacked size | 5.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 7402 |
| Author | berstend |
| Maintainers | berstend |
| Keywords | puppeteer, puppeteer-extra, puppeteer-extra-plugin, user-prefs, user-preferences, chrome, headless, pupeteer |

## Links

- npm: https://www.npmjs.com/package/puppeteer-extra-plugin-user-preferences
- Repository: https://github.com/berstend/puppeteer-extra
- Homepage: https://github.com/berstend/puppeteer-extra#readme
- Issues: https://github.com/berstend/puppeteer-extra/issues
- npm.io page: https://npm.io/package/puppeteer-extra-plugin-user-preferences

## Dependencies (4)

- [debug](https://npm.io/package/debug.md) ^4.1.1
- [deepmerge](https://npm.io/package/deepmerge.md) ^4.2.2
- [puppeteer-extra-plugin](https://npm.io/package/puppeteer-extra-plugin.md) ^3.2.3
- [puppeteer-extra-plugin-user-data-dir](https://npm.io/package/puppeteer-extra-plugin-user-data-dir.md) ^2.4.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

- 2.4.1 (latest) — 2023-03-01
- 2.4.0 — 2022-07-08
- 2.3.3 — 2022-07-07
- 2.3.2 — 2022-07-07
- 2.3.1 — 2021-09-23
- 2.3.0 — 2021-09-21
- 2.2.13 — 2021-09-17
- 2.2.12 — 2021-03-14
- 2.2.11 — 2021-02-03
- 2.2.10 — 2021-02-02
- 2.2.9 — 2021-02-02
- 2.2.8 — 2021-01-13
- 2.2.7 — 2020-07-23
- 2.2.6 — 2020-07-09
- 2.2.5 — 2020-07-08
- … 15 more at https://npm.io/package/puppeteer-extra-plugin-user-preferences/versions

## README

# puppeteer-extra-plugin-user-preferences

> A plugin for [puppeteer-extra](https://github.com/berstend/puppeteer-extra).

### Install

```bash
yarn add puppeteer-extra-plugin-user-preferences
```

## API

<!-- Generated by documentation.js. Update this documentation by updating the source code. -->

#### Table of Contents

-   [Plugin](#plugin)

### [Plugin](https://github.com/berstend/puppeteer-extra/blob/db57ea66cf10d407cf63af387892492e495a84f2/packages/puppeteer-extra-plugin-user-preferences/index.js#L30-L73)

**Extends: PuppeteerExtraPlugin**

Launch puppeteer with arbitrary user preferences.

The user defined preferences will be merged with preferences set by other plugins.
Plugins can add user preferences by exposing a data entry with the name `userPreferences`.

Overview:
<https://chromium.googlesource.com/chromium/src/+/master/chrome/common/pref_names.cc>

Type: `function (opts)`

-   `opts` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** Options (optional, default `{}`)
    -   `opts.userPrefs` **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** An object containing the preferences. (optional, default `{}`)

Example:

```javascript
const puppeteer = require('puppeteer-extra')
puppeteer.use(require('puppeteer-extra-plugin-user-preferences')({userPrefs: {
  webkit: {
    webprefs: {
      default_font_size: 22
    }
  }
}}))
const browser = await puppeteer.launch()
```

* * *

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