Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/edm00se/parcel-plugin-goodie-bag

provides the Promise and fetch goodies needed for IE(11) support w/ parcel bundle loading
https://github.com/edm00se/parcel-plugin-goodie-bag

fetch ie parceljs plugin polyfill promise

Last synced: 2 months ago
JSON representation

provides the Promise and fetch goodies needed for IE(11) support w/ parcel bundle loading

Awesome Lists containing this project

README 

        
# Archived



Per [issue #55](https://github.com/edm00se/parcel-plugin-goodie-bag/issues/55), this repository is being archived.



# parcel-plugin-goodie-bag



A polyfill for `Promise` and `fetch` **for Parcel v1**, to keep it working for those browsers without it.



[Looking at you Internet Explorer](https://techcommunity.microsoft.com/t5/Windows-IT-Pro-Blog/The-perils-of-using-Internet-Explorer-as-your-default-browser/ba-p/331732).



## [Parcel v1 Only!](https://github.com/edm00se/parcel-plugin-goodie-bag/issues/18#issuecomment-803409442)



## Why This Is Needed



TL;DR: multiple bundle support in Parcel, such as using the ability to require html partial files, makes direct use of both the `Promise` and `fetch` APIs, directly.



This plugin is born of my frustaration with the scenario outline in [parcel issue #2364](https://github.com/parcel-bundler/parcel/issues/2364). This requires additional intervention, since the native requirement of the potentially un-polyfilled APIs is prior to any polyfill via `babel-polyfill` and isn't something that can be influenced inside the application source itself; at least not without convoluted efforts.



## Installation



- `npm install --save-dev parcel-plugin-goodie-bag`



## Usage



No additional configuration required. If your app is being bundled by parcel and you have this plugin installed, the processed application will build with:



- the `*.html` containing a `script` tag in its head pointing to the "goodie bag` script (the two polyfills)

- a "goodie bag" script file, placed in the destination directory (`outDir` to parcel, defaults to `dist`)

- the script tag will respect your configured `publicUrl` option with Parcel (e.g.- prefixed with default `/` or no root slash in the case of `.`)



Note: If you're not processing your `index.html` file through parcel, for example merely bundling the JS directly, I believe you're missing out on some of the super powers of parcel. However, if that's your workflow and you're missing out on this plugin's functionality, please consult the discussion and resolution outlined [in this issue][non-html-support].



## In Action



I made use of [a simple reproducible repository](https://github.com/edm00se/parcel-ie11-issue-demo) I had set up for tracking this issue.



| Before                         | After                        |

|--------------------------------|------------------------------|

| ![before](assets/before.jpg)   | ![after](assets/after.jpg)   |



## Contributing



If you have something to contribute, please do. If you're uncertain as to whether or not to open a PR, feel free to ask; just open an issue and mark that it's a question.



## Contributors ✨



Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):



  

    Eric McCormick
Eric McCormick
📝 🐛 💻 🖋 📖 💡 🤔 🚧 👀 📓

    Joe Withey
Joe Withey
💻 🤔

    Klaus Breyer
Klaus Breyer
🐛 🤔

  



This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!



## History



Parcel is an amazing bundler with superpowers. The fact that my ability to support IE(11), a requirement for my day job, was hampered by this limitation of a multiple bundle scenario meant that I had to solve the problem myself. It is my hope that one day the configuration of Parcel will allow for the surfacing of base level APIs, such as `Promise` and `fetch` to make this plugin unnecessary. Until then, I'll keep this available to provide some sanity.



## Credits

- [parcel](https://parceljs.org/)



## License



MIT



[non-html-support]: https://github.com/edm00se/parcel-plugin-goodie-bag/issues/2#issuecomment-502219004