JavaScript Files and Libraries Review Process
If you want to use JavaScript files or libraries on your EPA website, follow these steps to ensure that the files or libraries are safe, secure, and accessible.
- Check if the file or library is already approved by EPA.
- If the file or library is not approved, request approval from EPA.
- You will develop and test your code on the Drupal WebCMS development server.
- The development server has the same code as the production environment. If you have an account on the production server, you also have an account on the sandbox.
- Provide the JS files to OMS so that we can load them into the sandbox. A list of dependencies must be provided to OMS so that the JavaScript can be loaded in the correct order on the page. Once the files are available, build your page and code.
- You will develop and test your code on the Drupal WebCMS development server.
- Contact the TZ Service Manager in OMS to set up a TZ account to pay for the code review under Working Capital Fund Services. No work can take place until you have a registration id/charge code set up for vetting submitted code.
- Wait for EPA to review your request. EPA will check if the file or library meets the following criteria:
- It does not contain any malicious code or vulnerabilities
- It does not conflict with other files or libraries on EPA websites
- It follows the web standards and best practices for JavaScript
- It is compatible with different browsers and devices
- It does not affect the performance or usability of EPA websites
- It supports accessibility for people with disabilities
- If EPA approves your request, your code will be uploaded to production, so you can link to it on your production pages.
- If EPA denies your request, you will receive an email with the reasons for denial and suggestions for alternatives. You will not be able to use the file or library on your website.
Examples of Using JavaScript for "Small" Applications
- Superfund Where you Live dataset has over 1,800 Superfund locations.
- Region 1's Charles River Buoy dataset dynamically pulls data from environmental readings and displays the data with Highcharts.
- EPA RCRA ID: AKD000643239: This page uses the ID number and this script to query an EPA service at ofmpub.epa.gov/enviro.
- Air Data - Tile Plot: This page uses JS to poll a CGI script hosted on www3 and insert that data into the HTML.
- Resilient Strategies Guide for Water Utilities: This page uses ReactJS to store responses and generate a guide for water utilities.