polyfill-lambda is a service deployed to Amazon Web Services that returns JavaScript polyfills based on the user agent of the requesting browser. You can use this package to deploy your own version for your service or organization.
Ensure you have node and yarn installed.
- Run
yarnin the root of the repository to get the dependencies. - Create a
src/features.jsfile (you can copy the sample) containing the features that you want polyfilled. You can take a look at polyfill.io's docs for the available options. - Create a
src/headers.jsfile (you can copy the sample) containing the desired headers to be served alongside the JavaScript.
Now you can run yarn start to start a local server at http://localhost:8080. Visit that location in different browsers to view the polyfill. Note that since this server is running in development, it returns unminified JavaScript.
First, copy serverless-env.yml.sample to serverless-env.yml and fill in the relevant information. Below are the explanation for the options:
bucket.name- any name unique to S3. Nothing actually gets stored in here, it's just used as the origin for CloudFrontdistribution.alias- the domain that will be used for the CloudFront distribution (presumably something likepolyfill.culturehq.com)distribution.cert-arn- the ARN of an AWS Certificate Manager certificate that matches the alias (as in, as certificate forpolyfill.culturehq.com)
With the config in place, install serverless by running npm install -g serverless. You can then run sls deploy --aws-profile [PROFILE] to deploy the lambda function, S3 bucket, and CloudFront distribution.
Once everything has been deployed, you can associate the CloudFront distribution with your domain through AWS Route53 by creating an alias record for the appropriate hosted zone. Then you can include script tag like the below to conditionally load only the correct polyfills:
<script type="text/javascript" src="https://polyfill.culturehq.com"></script>Bug reports and pull requests are welcome on GitHub at https://github.com/CultureHQ/polyfill-lambda.
The code is available as open source under the terms of the MIT License.