API Reference

Requesting a minified polyfill bundle

Get a bundle of polyfills which have been minified ready for production website use. This endpoint responds with a JavaScript file containing the polyfills which should be served to the requesting browser.

Request

Method GET
Path /v3/polyfill.min.js
Querystring
callback
Name of the JavaScript function to call after the polyfill bundle is loaded.
unknown
What to do for browsers which are not supported. Possible values are `ignore` and `polyfill`. Setting to `ignore` will return no polyfills to unsuported browsers. Setting to `polyfill` will return all requested polyfills to unsupported browsers.
flags
Configuration settings for every polyfill being requested. Possible values are `always` and `gated`. Setting `always` will return all requested polyfills to every browser. Setting `gated` will wrap every polyfill within a feature detection, only adding the polyfill if the feature was not detected. To enable both settings, separate them with a comma E.G. `always,gated`.
Headers
User-Agent
If no `ua` querystring value is configured, the User-Agent header's value will be used for polyfill targeting instead.
Accept-Encoding
If no `compression` querystring value is configured, the Accept-Encoding header's value will be used to decide if compression should be used on the polyfill

Example request:

Requesting the polyfill sets: ES5, ES6, and ES7. Wrapping each polyfill in a feature detect

https://polyfill.io/v3/polyfill.js?features=es5,es6,es7&flags=gated

Response

Status 200 on success
401 if authentication failed
403 if authorization failed
404 if there are no non-hidden demos for the :repo-id and :version-id
Headers
Content-Type
text/javascript;charset=UTF-8
Normalized-User-Agent
The User-Agent that was detected and was used for polyfill targeting.
Body The bundle of JavaScript polyfills.