README.md

Polyfills for StimulusReflex

Description

The @stimulus_reflex/polyfills package provides support for StimulusReflex and CableReady in older browsers like Internet Explorer 11.

Usage

To include the polyfills you just have to import the package. Typically you want to import it in app/javascript/packs/application.js.

// app/javascript/packs/application.js

import '@stimulus_reflex/polyfills'
import 'controllers'

// ...

If you have an existing import for @stimulus/polyfills you can safely remove it. The @stimulus/polyfills package is included with @stimulus_reflex/polyfills.

-import '@stimulus/polyfills'
+import '@stimulus_reflex/polyfills'

Details

This repository contains a few polyfills itself and bundles up polyfills from other packages. The following list shows the included polyfills and where they are coming from:

Polyfills included/imported in this package

• Custom

  • NodeList.forEach()

• core-js

  • String.startsWith()
  • String.includes()

Polyfills imported from @stimulus/polyfills

• core-js
  • Array.find()
  • Array.findIndex()
  • Array.from()
  • Map
  • Object.assign()
  • Promise
  • Reflect.deleteProperty()
  • Set
• element-closest
  • Element.closest()
• mutation-observer-inner-html-shim
  • MutationObserver support for Internet Explorer 11
• eventlistener-polyfill
  • once & passive support for Internet Explorer 11 & Edge

Polyfills imported from @cable_ready/polyfills

• CustomEvent

• core-js

  • Array.flat()
  • Array.forEach()
  • Array.from()
  • Array.includes()
  • Object.entries()
  • Promise

• <template>

Polyfills imported from formdata-polyfill

• FormData