# polyshim

> DOM and ECMAScript polyfills

Latest version **0.1.3** (published 2019-06-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install polyshim
pnpm add polyshim
yarn add polyshim
bun add polyshim
```

## Health

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

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.3 |
| Published | 2019-06-10 |
| First published | 2019-02-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 46 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Maintainers | paulzi |

## Links

- npm: https://www.npmjs.com/package/polyshim
- Repository: https://github.com/paulzi/polyshim
- Homepage: https://github.com/paulzi/polyshim#readme
- Issues: https://github.com/paulzi/polyshim/issues
- npm.io page: https://npm.io/package/polyshim

## Recent versions

- 0.1.3 (latest) — 2019-06-10
- 0.1.2 — 2019-06-06
- 0.1.1 — 2019-02-13
- 0.1.0 — 2019-02-12

## README

# Polyshim

[![NPM version](http://img.shields.io/npm/v/polyshim.svg?style=flat)](https://www.npmjs.org/package/polyshim)
[![Build Status](https://img.shields.io/travis/paulzi/polyshim/master.svg)](https://travis-ci.org/paulzi/polyshim)
[![Downloads](https://img.shields.io/npm/dt/polyshim.svg)](https://www.npmjs.org/package/polyshim)
![License](https://img.shields.io/npm/l/express.svg)

A set of polyfills and shims for working with DOM and ECMAScript.

[Russian readme](https://github.com/paulzi/polyshim/blob/master/README.ru.md)

## Install

```sh
npm install polyshim
```

## Usage

The library offers two use cases:

### Polyfill

Just connect the necessary polyfills, and use the functionality as if the functionality was supported by browsers:

```javascript
import 'polyshim/polyfill/closest';

let item = document.querySelector('.component .component__item');
let component = item.closest('.component');
```

### Shim

The use of shims allows you to "not touch" the native methods, thus without overwriting perhaps another implementation of polyfills. This is especially useful for writing redistributable libraries.

```javascript
import closest from 'polyshim/shim/closest';

let item = document.querySelector('.component .component__item');
let component = closest.call(item, '.component');
```

## Polyfill list

- Object.assign
- Element.prototype.matches
- Element.prototype.closest
- DOMTokenList.prototype.toggle (force parameter)
- Event (constructor)
- CustomEvent (constructor)

## Testing

To run tests, use:

```sh
npm test
```

If necessary, you can install launchers for other browsers and activate them in `karma.conf.js`:

```sh
npm i --save-dev karma-ie-launcher
```

## Browser support

- Internet Explorer 11+
- Other modern browsers

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